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SECTION  I 


INTRODUCTION 

This  User's  Manual  is  one  of  four  manuals  documenting  the  ASTROS 
(Automated  STRuctural  Optimization  System) .  The  other  three  are  the  Applica¬ 
tions  Manual,  the  Programmer's  Manual  and  the  Theoretical  Manual,  The  Appli¬ 
cations  and  Theoretical  Manuals  indicate  the  range  of  capabilities  of  the 
ASTROS  system  while  the  Programmer's  Manual  is  provided  to  give  details  of  the 
internal  workings  of  the  engineering  modules.  The  User's  Manual  provides  a 
complete  description  ot  the  user  interface  to  the  ASTROS  system  in  order  to 
facilitate  the  preparation  of  input  data.  It  introduces  the  features  of  the 
ASTROS  system  that  enable  the  user  to  direct  this  software  system  and  docu¬ 
ments  the  mechanisms  by  which  the  user  can  communicate  with  the  system.  It  is 
assumed  that  the  reader  is  familiar,  from  a  study  of  the  Theoretical  Manual, 
with  the  engineering  capabilities  of  the  ASTROS  system  and  is  using  this 
manual  to  define  the  form  of  the  particular  input  that  directs  the  system  to 
perform  a  desired  function.  This  manual  is  intended  to  provide  the  user  with 
a  convenient  reference  for  all  forms  of  input  to  the  system  and  is  therefore 
organized  along  the  same  lines  as  the  input  data  stream.  The  discussion  of 
each  topic  is  brief  and  as  generic  as  possible  with  the  detailed  documentation 
isolated  in  the  appendices.  Information  on  ASTROS  output  formats  is  also 
provided. 

This  manual  is  directed  toward  the  engineer/designer/analyst  who  is 
using  ASTROS  to  perform  engineering  design  or  analysis.  While  ASTROS  is 
perfectly  capable  of  performing  many  tasks  not  explicitly  supported  in  the 
standard  execution,  the  user  must  know  the  engineering  software  in  considera¬ 
ble  detail  to  direct  the  procedure  to  perform  these  alternative  functions. 
The  mechanisms  by  which  these  more  advanced  features  are  invoked  are  included 
in  this  manual  but  no  attempt  is  made  to  provide  sufficient  information  to  the 
user  to  generate  new  analysis  features  or  to  grossly  modify  the  existing 
capabilities  of  the  system.  These  more  advanced  topics  are  treated  in  the 
Programmer's  and  Application  Manuals  which  document  the  individual  modules  in 
the  system  and  their  interactions.  Rudimentary  (and  typical)  modifications  to 
the  execution  sequence  and  changes  to  execution  parameters  are  discussed  in 
detail  in  this  manual. 
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Machine  and  installation  dependent  aspects  of  AFTROS  are  also  con 
tained  in  the  Application  and  Programmer's  Manuals  rather  than  in  the  User's 
Manual.  Only  those  machine  dependency  issues  that  are  logically  related  to 
the  preparation  of  the  input  are  discussed  in  the  User's  Manual.  Machine 
dependencies  in  the  input  are  limited  to  the  naming  conventions  for  the  run 
time  data  base  file(s)  and  the  parameters  that  can  be  u.«^  ’  on  the  ASSIGN 
DATABASE  entry.  Other  machine  dependencies  are  handled  as  part  of  the  instal 
lation  of  the  system  on  each  particular  host  machine.  These  issues  are 
documented  in  the  Programmer's  Manual  since  they  are  relevant  only  to  the 
"system  manager not  to  the  "user." 

It  will,  be  apparent  to  many  readers  that  the  NASTRAN  structural 
analysis  system  was  used  as  a  guide  in  the  design  of  the  ASTROS  procedure 
Both  NASTRAN  and  ASTROS  comprise  large  scale,  finite  element  structural 
analysis  in  executive  driven  software  systems.  Therefore,  many  of  the  input 
and  output  features  are  similar.  NASTRAN  his  become  an  industry  standard  in 
finite  element  structural  analysis  with  many  pre-  and  post-processors  devel¬ 
oped  around  NASTRAN  data.  In  order  to  facilitate  acceptance  and  use  of  the 
ASTROS  procedure,  NASTRAN  compatibility  was  considered  desirable  in  many 
areas.  As  a  result,  many  aspects  of  the  ASTROS  input  are  similar  in  form  or 
purpose  to  those  in  NASTRAN  and,  in  many  other  cases,  the  same  nomenclature 
has  been  adopted.  Therefore,  in  some  instances  in  this  document,  ASTRCS  input 
will  be  compared  and  contrasted  to  NASTRAN  input  in  order  to  present  a  concise 
picture  of  the  ASTROS  input  and  to  assist  the  reader  familiar  with  NASTRAN  in 
making  the  connection  to  the  equivalent  item  in  ASTROS.  Although  familiarity 
with  NASTRAN  is  not  a  prerequisite  to  understanding  the  ASTROS  documentation, 
sufficient  numbers  of  potential  ASTROS  users  are  expected  to  be  familiar  with 
the  NASTRAN  system  to  justify  the  sometimes  casual  reference  to  NASTRAN 
features. 

Section  II  contains  a  description  of  the  ASTROS  input  file  with  the 
remaining  Sections  III  through  VI  organized  to  parallel  the  input  file  struc¬ 
ture.  Within  each  section,  the  function  of  the  particular  input  packet  is 
presented  along  with  illustrations  of  how  the  data  are  prepared.  Each  packet 
is  described  in  a  generic  fashion  so  as  to  indicate  how  the  sophisticated  user 
can  make  use  of  the  more  advanced  features  of  the  system  without  cluttering 
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the  discussion  with  details  of  the  input  structures.  The  detailed  documenta¬ 
tion  of  the  separate  input  structures  of  the  data  packet  are  in  an  accompany¬ 
ing  appendix.  This  form  of  user's  documentation  enables  this  manual  to  be 
useful  as  a  guide  to  the  beginning  user  as  well  as  a  reference  for  the  experi¬ 
enced  user . 

In  Section  VII,  following  the  input  stream  descriptions,  the  output 
features  of  the  ASTROS  system  are  documented.  While  these  features  are 
selected  through  directives  in  the  input  data  stream,  they  are  sufficiently 
numerous  and  complex  to  justify  a  separate  section  devoted  solely  to  output 
requests.  The  output  capabilities  of  the  system  are  described  in  very  general 
terms  while  the  output  requests  available  for  each  analysis  discipline  and 
optimization  feature  are  documented  in  detail.  Most  output  is  selected 
through  Solution  Control  directives  that  are  documented  in  Section  V,  but  some 
are  selected  through  modifications  to  the  executive  (MAPOL)  sequence.  Section 
VII  documents  all  of  the  output  utilities  available  to  the  user  through  MAPOL 
directives  and  gives  several  examples  of  modifying  the  MAPOL  sequence  to 
obtain  additional  output.  Other  features  are  described  in  the  MAPOL  Program¬ 
mer's  Manual. 


Many  examples  of  user  input  are  used  throughout  this  document  and  the 
appendices.  In  order  to  ease  the  burden  of  interpretation,  the  following 
conventions  will  be  used  in  the  examples  unless  otherwise  noted. 


MAPOL  NOGO 


MAPOL  params 


MAPOL 


1  NOGO  J 


Capital  letters  indicate  that  the  phrase  must 
appear  exactly  as  shown 

Lower  case  symbols  act  as  generic  place 
holders  indicating  that  an  option  or  options 
can  or  must  be  included 

Symbol(s)  enclosed  in  braces  {  )  are  optional 
If  more  than  one  symbol  is  available  they 
be  stacked  in  vector  notation  with  any 
defaults  denoted  by  underlines. 


INCLUDE  <filename>  A  required  symbol  is  enclosed  in  angle 

brackets.  If  the  angle  brackets  surround  an 
option  list,  at  least  one  of  the  available 
options  must  be  selected. 

BEGIN  A  BULK  The  caret  (A)  is  used  to  signify  a  required 

blank  space. 
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In  sone  cases,  the  appendices  represent  standalone  documents  with 
their  own  conventions  that  may  differ  from  those  in  the  main  body. 
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SECTION  II 


THE  INPUT  DATA  STREAM 

The  ASTROS  user  directs  the  system  through  an  input  data  stream 
composed  of  a  command  to  attach  the  ASTROS  run  time  data  base  followed  by 
multiple  data  packets.  Each  packet  contains  a  set  of  related  data  providing 
the  information  needed  to  execute  the  ASTROS  procedure.  The  packets  begin 
with  a  keyword  indicating  the  nature  of  the  data  within  the  packet  and  termi¬ 
nate  with  an  ending  keyword  or  with  the  start  of  the  next  data  packet.  All 
the  packets  in  the  input  data  stream  are  optional,  although  the  order  in  which 
they  must  appear  is  fixed.  The  purpose  of  this  section  is  to  document  the 
structure  of  the  input  data  stream.  Detailed  documentation  of  the  data  within 
each  data  packet  is  then  presented  in  separate  sections. 

Figure  1  shows  the  general  form  of  the  input  data  stream.  The  first 
non-blank  record  of  the  input  file  must  be  the  ASSIGN  DATABASE  entry.  This 
command  enables  the  user  to  attach  the  run  time  data  base  file(s)  that  are 
used  during  the  execution  of  the  ASTROS  procedure.  There  are  four  optional 
data  packets  following  the  ASSIGN  DATABASE  entry  which,  if  they  are  present, 
must  appear  in  the  order  shown.  The  first  is  the  DEBUG  packet  which  contains 
"debug"  commands  to  control  or  select  specific  actions  within  the  executive 
and  data  base  management  systems.  The  second  packet  is  the  MAPOL  packet 
containing  the  executive  system  control  directives  consisting  of  either  a 
standalone  MAPOL  program  or  EDIT  commands  to  modify  the  standard  MAPOL  pro¬ 
gram.  If  the  MAPOL  packet  is  absent,  the  unmodified  standard  MAPOL  sequence 
directs  the  execution.  The  Solution  Control  commands  appear  in  the  third 
optional  packet  denoted  by  the  keyword  SOLUTION.  These  commands  select  the 
engineering  data  to  be  used  in  each  subcase  from  the  set  of  data  provided  in 
the  fourth  and  final  data  packet:  the  BULK  DATA  packet.  The  BULK  DATA  packet 
contains  the  engineering  data  describing  the  finite  element  structural  model, 
the  aerodynamic  model(s),  and  the  design  model,  as  well  as  all  the  data  needed 
to  perform  the  specific  analysis  and/or  optimization  tasks.  The  MAPOL, 
SOLUTION  and  BULK  DATA  packets  are  analogous  to  the  NASTRAN  executive  control, 
case  control  and  bulk  data  decks,  respectively. 
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In  interpreting  the  input  data  stream,  ASTROS  recognizes  the  keywords 
shown  in  Table  1.  These  keywords  must  begin  in  the  first  column  and  have  the 
structure  shown.  In  some  cases  the  keyword  is  also  a  command  line  that  makes 
up  part  of  the  data  packet  which  it  initiates.  In  these  cases,  the  command 
parameters  are  documented  in  the  User's  Manual  section  discussing  the  details 
of  the  associated  data  packet.  For  example,  the  MAPOL  keyword  is  part  of  a 
command  that  directs  the  MAPOL  compiler  to  take  certain  actions.  The  detailed 
discussion  of  the  MAPOL  command  is  therefore  contained  in  the  MAPOL  Program¬ 
mer's  Manual  (Appendix  B  of  this  report)  and  in  Section  IV. 

TABLE  1.  KEYWORDS  RECOGNIZED  BY  THE  INPUT  STREAM  INTERPRETER 


KEYWORD 

DEFINITION 

ASSIGN  DATABASE 

Identifies  the  run-time  data  base  files 

DEBUG 

Initiates  the  DEBUG  Packet 

MAPOL 

Command  line  which  initiates  a  MAPOL  packet  containing 
a  complete,  user  defined  MAPOL  program. 

EDIT 

Command  line  which  initiates  a  MAPOL  packet  containing 
edit  commands  modifying  the  standard  executive  sequence. 

SOLUTION 

Initiates  the  SOLUTION  CONTROL  packet. 

BEGIN  (BULK) 

Initiates  the  BULK  DATA  packet. 

ENDDATA 

Optionally  terminates  the  BULK  DATA  packet. 

INCLUDE 

Directs  ASTROS  to  include  input  data  from  additional 
files . 

Two  keyword  commands  are  related  only  to  the  input  data  stream  and  not 
to  the  data  within  a  packet.  These  are  the  ASSIGN  DATABASE  and  the  INCLUDE 
commands.  Each  of  these  is  discussed  in  detail  in  the  following  subsections. 

2.1  THE  ASSIGN  DATABASE  ENTRY 

The  first  line  of  the  ASTROS  input  data  stream  must  be  the  ASSIGN 
DATABASE  entry.  This  entry  identifies  the  run  time  data  base  files  to  be  used 
in  the  current  ASTROS  execution  and  specifies  certain  parameters  associated 
with  the  files.  The  format  of  this  entry  is; 
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ASSIGN  DATABASE  <dbname>  <password>  <status>  (params) 


where, 

is  a  name  identifying  the  run  time  data  base  files 
(maximum  of  8  characters) 

is  a  user  assigned  password  for  the  data  base  files 
(maximum  of  8  characters) 

is  the  status  of  the  data  base  files.  Must  be  either 
OLD,  NEW  or  TEMP 

are  optional  (installation  dependent)  parameters  e.g., 
DBLKSIZE  -  n,  IBLKSIZE  -  n,  etc. 

The  entries  on  the  ASSIGN  DATABASE  command  are  NOT  keyword  controlled  and  so 
must  be  input  in  the  order  shown.  They  can  be  separated  by  any  number  of 
blank  characters  or  commas  but  must  reside  on  one  physical  record  of  the  input 
data  stream.  Note  that  two  commas  do  not  imply  that  a  parameter  is  missing; 
instead,  the  second  comma  will  be  ignored.  Two  equivalent  examples  are  shown 
below: 

ASSIGN  DATABASE,  ASTSC,  KIMBERLY,  OLD 
ASSIGN  DATABASE  ASTSC  KIMBERLY  OLD 

Figure  2  is  provided  to  illustrate  the  function  of  the  ASSIGN  DATABASE  entry. 
In  the  case  shown,  the  installation  dependent  parameter  VOL  has  been  imple¬ 
mented  which  allows  selection  of  the  physical  device  on  which  the  requested 
file(s)  DB1  reside. 

The  optional  "params"  on  the  ASSIGN  DATABASE  entry  may  or  may  not  be 
keyword  controlled  and  are  installation  dependent.  They  provide  a  mechanism 
for  the  user  to  direct  machine  or  installation  dependent  file  operations  to  be 
performed  by  the  ASTROS  procedure.  At  each  site,  the  installation  of  the  code 
involves  a  definition  of  these  parameters  and  the  form  they  must  take.  The 
ASTROS  procedure  is  currently  functional  on  five  host  systems:  IBM  370 

series,  Perkin  Elmer  30XX  series,  VAX/VMS  and  MicroVMS,  VAX/Ultrix  and  CRAY. 
Appendix  A  documents  the  installation  dependent  ASSIGN  DATABASE  parameters  for 
most  of  these  systems  as  defined  by  the  ASTROS  system  installer  at  each  site. 
The  Programmer's  Manual  contains  the  detailed  description  of  how  these  and 
other  machine  dependent  parameters  are  defined. 


dbname 


password 


status 


params 
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The  input  data  stream  typically  resides  in  a  single  file,  but  the  user 
can  direct  the  input  stream  interpreter  to  include  other  files  through  the  use 
of  the  INCLUDE  directive  in  the  primary  input  stream.  The  format  of  the 
INCLUDE  command  is: 


INCLUDE  <filename> 


where , 


filename  is  a  name  identifying  the  file  to  be  included 
(maximum  of  72  characters). 

The  filename,  which  is  used  in  a  FORTRAN  open  statement,  must  satisfy  the 
requirements  of  the  particular  host  system  for  file  names.  Beyond  this 
restriction,  the  user  is  free  to  have  any  set  of  contiguous  non-blank  charac¬ 
ters  in  the  filename.  In  order  to  avoid  the  possibility  of  an  infinite 
recursion,  there  is  a  restriction  on  the  include  feature  that  no  INCLUDE 
statement  can  appear  in  a  file  that  is  being  included.  For  example,  if  the 
file  "TENBAR"  is  being  included,  it  may  not  itself  contain  an  INCLUDE 
directive.  The  input  stream  interpreter  will  terminate  with  an  appropriate 
error  message  if  this  should  occur. 

The  INCLUDE  directive  can  appear  anywhere  in  the  input  stream  after 
the  ASSIGN  DATABASE  entry.  The  ASSIGN  DATABASE  must  always  appear  as  the 
first  non-blank  line  in  order  to  allow  the  use  of  the  run  time  data  base  in 
the  subsequent  input  stream  interpretation.  A  single  data  packet  can  be  split 
among  included  files  or  an  INCLUDE  file  may  contain  parts  of  multiple  data 
packets.  The  input  interpreter  merely  replaces  the  INCLUDE  directive  with  the 
data  contained  in  the  named  file  so  the  only  requirement  is  that  the  input 
stream  that  results  from  the  combination  of  all  INCLUDE' s  have  the  form  of  a 
normal  input  stream.  The  INCLUDE  feature  can  be  very  useful  in  certain 
circumstances.  For  example,  a  special  user  developed  MAPOL  sequence  can  be 
stored  and  externally  maintained  from  the  files  containing  the  engineering 
data  for  particular  runs;  or,  conversely,  the  bulk  data  representing  a  large 
model  can  be  included  into  the  file  containing  the  solution  control 
directives. 


SECTION  III 


THE  DEBUG  PACKET 

The  debug  packet  represents  a  legitimization  of  a  development  tool  and 
is  intended  to  be  used  primarily  by  those  responsible  for  maintaining  the 
software.  The  debug  packet  provides  the  system  programmer  with  the  means  to 
invoke  or  control  certain  executive  and  data  base  management  system  functions 
that  are  helpful  in  tracking  the  ASTROS  execution  and/or  testing  the  executive 
and  data  base  management  system  software.  However,  because  some  of  the  debug 
options  can  be  useful  to  the  general  user,  the  debug  packet  is  fully  document¬ 
ed  in  the  User's  Manual  rather  than  in  the  Programmer's  Manual.  This  section 
documents  each  of  the  debug  options  and  indicates  how  the  option  can  be  useful 
in  debugging  the  ASTROS  procedure.  Emphasis  is  placed  on  those  debug  options 
that  are  of  interest  to  the  general  user. 

The  debug  packet  is  initiated  by  the  keyword  DEBUG,  which  must  appear 
alone  on  the  line  of  the  input  stream  that  follows  the  ASSIGN  DATABASE  entry 
and  that  precedes  any  other  data  packet.  Following  the  initiator,  any  number 
of  debug  lines  can  be  included  in  the  data  stream.  Each  debug  command  line 
can  be  composed  of  a  number  of  debug  commands,  appearing  in  any  order,  sepa¬ 
rated  by  blanks  or  commas .  The  DEBUG  packet  is  terminated  when  a  new  data 
packet  initiator,  or  the  end  of  the  input  stream,  is  encountered.  Most  debug 
commands  consist  of  single  keywords  which  toggle  flags  activating  the  debug 
functions .  The  appearance  of  these  debug  keywords  is  all  that  is  required  to 
activate  the  option.  Other  debug  commands  select  that  a  flag  take  on  a 
particular  value.  These  commands  have  the  form: 

<command>  -  <value> 

There  can  be  any  number  of  blanks  between  the  end  of  the  command  keyword,  the 
value  and  the  equal  sign,  but  neither  the  command  nor  the  value  can  contain 
imbedded  blanks.  Any  errors  in  the  debug  packet  input  will  result  in  warnings 
but  will  not  terminate  the  execution  and  the  erroneous  command  will  be  ig¬ 
nored. 

Table  2  shows  the  list  of  keywords  that  can  be  included  in  the  DEBUG 
packet.  The  debug  commands  are  grouped  into  executive  system  and  data  base 
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TABLE  2.  ASTROS  DEBUG  PACKET  COMMANDS 


EXECUTIVE  SYSTEM  DEBUGS 


KEYWORD 

DESCRIPTION 

MSTACK 

MAPOL  stack  output. 

MEXEC 

Execution  debugs  for  the  MAPOL  code. 

MOBJ 

Object  code  debugs  for  the  MAPOL  compilation. 

MTRACE 

MAPOL  instruction  trace  output. 

MATRIX 

Large  matrix  utility  trace. 

DATA  BASE/MEMORY  MANAGEMENT  DEBUGS 


KEYWORD 

DESCRIPTION 

TRACE 

Data  base  call  tracing. 

EVENT 

Data  base  event  tracing. 

BUFFER 

Data  base  buffer  dump. 

IOSTAT-<parra> 

Data  base  input/output  tracing.  <parm>  is  either  FULL 
for  a  complete  trace  and  statistical  summary  or  SUM  to 
limit  the  output  to  the  summary  of  I/O  statistics. 

ENTITY-Cname> 

Specifies  the  name  of  a  data  base  entity  which  limits 
the  TRACE,  EVENT,  BUFFER,  and  IOSTAT-FULL  options  to  be 
active  only  when  the  named  entity  is  open. 

CALLSTAT 

Compiles  a  summary  of  data  base  calling  statistics  for 
output  on  termination  of  the  execution. 

NOCOREDIR 

Stores  the  data  base  directories  on  the 
data  base  files  rather  than  in  memory. 

MEMORY 

Memory  management  call  tracing  and  checksum. 
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management  system  debugs.  Each  of  these  groups  is  described  in  greater  detail 
in  the  following  subsections. 

3.1  EXECUTIVE  SYSTEM  DEBUG  COMMANDS 

The  first  four  executive  system  keywords  in  Table  2  are  intended  to 
assist  the  system  programmer  in  following  the  actions  of  the  MAPOL  compiler 
and  execution  monitor.  As  such,  they  are  of  limited  value  to  the  general 
user.  The  MATRIX  option,  however,  can  be  useful  in  tracking  the  execution  of 
the  MAPOL  program.  It  echoes  the  matrix  utility  calls  for  all  matrix  opera¬ 
tions  that  are  in  the  MAPOL  sequence.  For  example,  if  the  MAPOL  program 
includes  the  expression: 

[A]  TRANS (  [B]  )  *  [C]  +  [D] ; 

the  MATRIX  trace  echoes  the  resultant  call  to  the  MPYAD  large  matrix  utility 
with  the  arguments  shown  in  detail.  This  trace  ccn  be  very  useful  in  deter¬ 
mining  which  particular  MAPOL  instruction  is  being  executed  when  a  problem 
occurs .  Large  MAPOL  programs  with  many  loops  and  a  large  number  of  matrix 
expressions  can  be  debugged  quite  simply  using  the  MATRIX  trace.  All  MAPOL 
statements  that  result  in  calls  to  any  of  the  large  matrix  utilities  (e.g., 
PARTN,  MERGE,  MPYAD,  MXADD,  etc.)  are  echoed. 

3.2  DATA  BASE  AND  MEMORY  MANAGER  DEBUG  COMMANDS 

The  data  base  management  system  has  a  number  of  debug  options  which 
can  be  divided  into  three  categories:  trace  options,  control  options  and 

memory  manager  options.  The  first  group  in  Table  2  contains  a  number  of 
tracing  options:  TRACE,  EVENT,  BUFFER,  and  IOSTAT.  The  IOSTAT  keyword 
selects  either  a  FULL  tracing  or  a  SUMmary.  The  first  three  of  these  options 
and  the  IOSTAT-FULL  option  are  further  controlled  by  the  ENTITY  option  which 
completes  the  first  group  of  keywords.  Note:  the  tracing  keywords  generate 
an  overwhelming  amount  of  data  which  are  often  of  limited  use  unless  the  user 
is  familiar  with  the  internal  structure  of  the  data  base  files.  The  ENTITY 
keyword  limits  the  activation  of  the  tracing  options  to  those  times  when  the 
named  data  base  matrix,  relation  or  unstructured  entity  is  open.  If  no  entity 
specification  is  made,  the  traces  are  active  for  all  data  base  operations.  In 
addition  to  their  role  in  debugging  the  data  base  software,  the  trace  options 
provide  a  useful  means  of  debugging  the  interface  between  a  user  written 
module  and  the  data  base. 
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The  data  base  control  options  CALLSTAT  and  NOCOREDIR  provide  user 
control  over  two  internal  data  base  functions.  The  CALLSTAT  option  compiles  a 
summary  of  the  number  of  calls  made  to  each  data  base  subroutine.  This 
summary,  in  combination  with  the  IOSTAT  option,  provides  statistics  on  the 
number  of  data  base  operations  in  the  execution.  The  NOCOREDIR  option  is  made 
available  for  machines  with  limited  core  memory  resources.  If  NOCOREDIR  is 
selected,  the  data  base  manager  stores  the  data  base  directories  on  the  data 
base  files  rather  than  in  core.  This  can  substantially  reduce  the  data  base 
memoi  r  requirements  at  the  cist  of  increasing  the  number  of  input/output 
operations . 

The  last  "group"  of  data  base  debug  options  consists  of  the  MEMORY 
command.  This  option  causes  an  echo  of  all  the  memory  management  calls  made 
in  the  modules.  The  user  can  then  track  the  ASTROS  execution  into  the  engi¬ 
neering  modules  themselves.  In  addition  to  the  echo,  the  MEMORY  option 
invokes  a  "checksum"  operation  which  checks  for  the  integrity  of  the  memory 
block  headers  on  every  memory  manager  operation.  If  the  checksum  fails,  a 
message  is  written  to  the  effect  that  a  block  header  has  been  overwritten. 
This  option  is  very  effective  in  uncovering  errors  in  engineering  modules  that 
make  use  of  dynamic  memory  allocation. 
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SECTION  IV 


THE  EXECUTIVE  SYSTEM  f MAPOL  PACKET) 

The  ASTROS  system  is  an  executive  controlled  software  procedure.  One 
of  the  functions  of  the  ASTROS  executive  system,  described  in  detail  in 
Reference  1,  is  to  determine  the  sequence  in  which  the  modules  of  the  proce¬ 
dure  are  invoked.  For  ASTROS,  the  Matrix  Abstraction  Problem  Oriented  Lan¬ 
guage  (MAPOL)  has  been  developed  to  perform  this  executive  system  task.  The 
MAPOL  language  has  its  conceptual  roots  in  the  Direct  Matrix  Abstraction 
Program  (DMAP)  capability  developed  for  the  NASTRAN  structural  analysis  system 
(Reference  2).  The  DMAP  "language,"  used  to  create  NASTRAN's  solution  algo¬ 
rithms  is  very  crude;  however,  it  has  been  a  major  factor  in  extending  the 
life  cycle  of  the  software.  It  provided  a  simple  method  of  installing  new 
code  and  functional  capabilities  into  the  system  and  afforded  the  user  an 
opportunity  to  interact  with  the  software .  MAPOL  provides  the  same  advantages 
to  the  ASTROS  system  and  represents  a  considerable  advance  over  DMAP  in  that 
MAPOL  is  a  structured,  procedural  language  that  directly  supports  high  order 
matrix  operations,  manipulation  of  data  base  entities  and  complex  data  types. 
Moreover,  the  syntax  of  the  language  looks  much  like  that  of  any  scientific 
programming  language  and  so  is  easily  learned  by  anyone  who  knows  FORTRAN  or 
PASCAL. 

From  the  user's  point  of  view,  ASTROS  is  directed  by  a  sequence  of 
control  statements  "coded”  in  the  MAPOL  language  just  as  a  NASTRAN  rigid 
format  is  coded  in  the  DMAP  "language."  The  executive  system  within  ASTROS 
compiles  the  MAPOL  program  and  executes  the  resultant  "ASTROS  machine  code" 
which  directs  the  execution  of  the  ASTROS  procedure .  (Note  that  ASTROS  is  NOT 
written  in  MAPOL,  only  the  executive  control  algorithm  is  written  in  the  MAPOL 
language.  In  fact,  ANSI  standard  FORTRAN  was  used  to  write  the  compiler  for 
MAPOL  and  all  the  engineering  software  of  the  ASTROS  system.)  This  control 
language  allows  the  user  to  manipulate  the  software  system  in  many  ways  to 
tailor  the  available  capabilities  to  perform  particular  tasks.  At  a  higher 
level  of  sophistication,  the  user  may  add  modules  to  the  system  or  replace 
modules  that  already  exist.  Obviously,  some  of  these  features  require  a 
knowledge  of  the  ASTROS  system  that  is  beyond  the  scope  of  the  User's  Manual. 
Those  features  that  require  detailed  information  are  more  fully  discussed  in 
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i. 


the  Programmer’s  Manual  but  their  existence  is  emphasized  here  in  order  to 
introduce  the  user  to  the  flexibility  that  the  executive  system  provides. 

The  remainder  of  this  section  serves  two  functions.  First,  it 
presents  the  mechanics  of  the  MAPOL  packet  and  second,  it  presents  the 
standard  MAPOL  sequence  that  has  been  developed  to  direct  the  optimization  and 
analysis  tasks  for  which  ASTROS  has  been  designed.  The  potential  of  the 
executive  system  to  tailor  the  ASTROS  procedure  will  be  explored  in  this 
discussion  of  the  standard  sequence.  In  support  of  this  section,  Appendix  B 
is  a  standalone  document  that  presents  the  MAPOL  language,  its  syntax  and 
features  while  Appendix  C  contains  an  annotated  copy  of  the  ASTROS  standard 
executive  sequence.  It  cannot  be  overemphasized  that,  while  the  capabilities 
implemented  in  the  ASTROS  software  are  significant,  the  true  power  embodied  in 
the  ASTROS  aystem  is  its  immense  flexibility,  largely  provided  by  the 
executive  system  and  its  MAPOL  language. 

The  MAPOL  packet  is  initiated  either  by  the  keyword  MAPOL  or  the 
keyword  EDIT  and  is  terminated  upon  encountering  the  SOLUTION  CONTROL  packet, 
the  BULK  DATA  packet  or  the  end  of  the  input  stream.  In  addition,  each  of  the 
initiator  keyword  commands  act  as  directives  to  the  MAPOL  compiler  to  take 
specific  actions.  The  exact  form  of  the  MAPOL  and  EDIT  commands  is: 


'  \  * 

r  i 

' 

MAPOL  ■  •  •  LIST  • 

or 

EDIT  - 

GO 

*  * 

LIST 

NOGoJ  [NOLI ST 

^NOGO, 

NOLIST 

where : 

GO/NOGO  selects  whether  the  MAPOL  program  is  to  be  execut¬ 

ed  after  compilation. 

LIST/NOLIST  selects  whether  the  MAPOL  source  code  is  to  be 
written  to  the  output  file. 


The  MAPOL  command  is  followed  by  a  MAPOL  program  which  can  be  any  syntactical¬ 
ly  complete  set  of  MAPOL  statements  as  described  in  the  MAPOL  Programmer's 
Manual  (Appendix  B) .  The  EDIT  command  indicates  that  the  MAPOL  packet  will 
consist  of  edit  commands  that  insert,  delete  or  replace  lines  of  the  standard 
executive  sequence. 
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4.1 


THE  MAPOL  PROGRAM 


If  the  MAPOL  packet  begins  with  the  MAPOL  command  line,  the  compiler 
assumes  that  the  remaining  statements  in  the  packet  constitute  a  complete 
MAPOL  program.  That  program  can  be  any  set  of  MAPOL  statements  that  satisfy 
the  rules  of  the  language  as  presented  in  Appendix  B.  The  program  can  call 
any  of  a  number  of  intrinsic  functions  (including  most  of  the  common  FORTRAN 
intrinsic  functions)  and  any  of  the  "engineering"  utilities  and  modules  that 
have  been  defined  to  the  compiler.  The  user  can  access  these  modules  in  any 
desired  order,  subject  only  to  limits  imposed  by  the  engineering  modules 
themselves.  In  addition,  the  user  can  write  special  purpose  modules  and 
define  them  to  the  compiler  through  the  SYSTEM  GENERATION  (SYSGEN)  program 
discussed  in  the  Programmer's  Manual.  Thus,  a  wide  range  of  tasks  can  be 
performed  using  the  ASTROS  system  in  combination  with  a  user's  MAPOL  program. 

The  MAPOL  language  can  be  read  and  written  easily  by  anyone  familiar 
with  a  scientific  programming  language.  This  feature  opens  the  advantages  of 
the  executive  system  to  the  average  user  without  requiring  specialized  knowl¬ 
edge  in  computer  science  or  requiring  effort  to  learn  a  radically  different 
programming  language.  The  user  will  often  find  the  simplicity  and  power  of 
the  MAPOL  language  enables  many  tasks  to  be  performed  using  the  ASTROS  system 
that  are  not  explicitly  supported  in  the  standard  executive  sequence. 

4.2  MAPOL  EDIT  COMMANDS 

If  the  MAPOL  packet  begins  with  the  EDIT  command  line,  the  compiler 
assumes  that  the  remainder  of  the  packet  (if  any)  is  composed  of  MAPOL  edit 
commands  and  new  MAPOL  statements  that  modify  the  standard  executive  sequence. 
The  set  of  edit  commands  is  given  in  Table  3  (and  in  Appendix  B) .  They  allow 
the  user  to  insert,  delete  and  replace  lines  of  the  standard  MAPOL  sequence. 
All  the  edit  commands  reference  a  line  number  or  range  of  line  numbers.  The 
line  numbers  are  those  in  a  compiled  listing  of  the  standard  MAPOL  sequence 
which  is  written  as  part  of  the  system  generation  task.  When  editing  the 
standard  sequence,  the  user  is  cautioned  to  obtain  the  most  recent  listing 
either  from  the  SYSGEN  output  or  by  executing  ASTROS  with  an  input  stream 
containing  only  an  ASSIGN  DATABASE  entry  and  the  one  line  MAPOL  packet: 

EDIT  LIST  NOGO 
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I 


I 


I 


I 


This  input  stream  will  result  in  an  output  file  containing  the  current  listing 
of  the  standard  executive  sequence. 

TABLE  3.  MAPOL  EDIT  COMMANDS 


STATEMENT 

FUNCTION 

EDIT 

Modify  the  standard  solution. 

DELETE  a[,b] 

Remove  lines  a  through  b  inclusive. 

REPLACE  a[,b] 

Remove  lines  a  through  b  inclusive  and 
replace  with  following  lines. 

INSERT  a 

Insert  the  lines  following  the  command 
after  line  a. 

4.3  THE  STANDARD  EXECUTIVE  SEQUENCE 

As  previously  mentioned,  the  MAPOL  language  has  its  conceptual  roots 
in  the  DMAP  "language."  To  allow  the  user  of  NASTRAN  to  perform  certain 
predefined  analyses,  a  set  of  "rigid  formats"  or  DMAP  algorithms  were  written, 
alleviating  the  user  of  the  need  to  learn  the  details  of  the  control  language. 
Each  rigid  format  allowed  the  user  to  perform  analyses  in  a  different 
engineering  discipline;  for  example,  static  structural  analyses,  normal  modes 
analyses,  or  transient  analyses.  In  a  similar  manner,  a  standard  executive 
sequence  or  MAPOL  algorithm  has  been  developed  for  the  ASTROS  system  which 
supports  all  the  engineering  disciplines  and  optimization  features  of  the 
procedure.  Unlike  the  multiple  DMAP  rigid  formats,  however,  there  is  a  single 
MAPOL  sequence  that  supports  all  the  available  engineering  disciplines  as  well 
as  optimization.  This  fundamental  difference  is  necessary  to  permit 
multidisciplinary  optimization. 

One  consequence  of  having  a  single  multidisciplinary  algorithm  is  that 
thr  standard  sequence  appears  to  be  very  complicated.  The  purpose  of  this 
subsection  is  to  present  the  internal  structure  and  flow  of  the  standard  MAPOL 
sequence,  thereby  providing  the  user  with  sufficient  information  to  tailor  the 
standard  sequence  to  suit  individual  needs.  The  discussion  in  this  section 
will  be  general  to  provide  the  necessary  overview  and  to  introduce  the 
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concepts  embodied  in  the  standard  sequence.  Modifications  to  the  standard 
sequence  are  presented  primarily  in  terms  of  capabilities,  but  the  presen¬ 
tation  is  supported  by  examples  that  represent  both  simple  and  more  complex 
modifications.  Appendix  C  supplements  this  discussion  with  a  detailed  line- 
by-line  presentation  of  the  standard  executive  sequence.  The  reader  is  also 
referred  to  the  Programmer's  Manual  for  information  on  the  addition  of  modules 
to  the  ASTROS  engineering  library. 

4.4  STANDARD  EXECUTIVE  SEQUENCE  STRUCTURE 

The  standard  MAPOL  sequence  consists  of  two  major  components: 
the  variable  declarations  and  the  solution  algorithm.  The  solution  algorithm 
can  be  further  divided  into  preface  modules,  the  optimization  segment  and  the 
final  analysis  segment.  The  declaration  segment  declares  all  variables  used 
in  the  MAPOL  sequence.  This  includes  all  integer  and  real  scalar  variables  as 
well  as  high  order  variables:  relations,  matrices  and  unstructured  data  base 
entities.  Within  the  solution  algorithm,  the  preface  modules  comprise  a  group 
of  engineering  modules  exercised  prior  to  the  boundary  condition  loops  to 
perform  a  number  of  system  initialization  tasks;  e.g.,  loads  generation  and 
the  computation  of  invariant  aerodynamic  matrices.  The  separate  optimization 
and  analysis  segments  consist  of  a  loop  on  the  number  of  (optimization  or 
analysis)  boundary  conditions  in  the  current  execution.  In  the  optimization 
segment,  a  second  boundary  condition  loop  is  performed  to  obtain  the  sensitiv¬ 
ities  of  active  boundary  condition  dependent  constraints  in  preparation  for 
the  optimization  task. 

Figures  3  and  4  juxtapose  the  standard  algorithm  structure  and  a  flow 
chart  showing  how  multidisciplinary  optimization  is  performed  in  ASTROS.  It 
is  readily  apparent  that  the  structure  of  the  standard  MAPOL  sequence  has  been 
determined  by  the  requirement  to  perform  multidisciplinary  optimization.  Each 
of  the  segments  of  the  standard  sequence  are  discussed  in  greater  detail  in 
the  following  subsections . 

4.4.1  MAPOL  Declarations 

MAPOL  is  a  strongly  typed  language  that  requires  all  variables  used  in 
a  program  unit  (either  the  main  program  or  a  procedure)  to  be  declared.  This 
applies  to  both  simple  variables  like  real  and  integer  scalar  or  array  varia¬ 
bles  and  to  high  order  variables  (like  MATRIX)  that  refer  to  data  base  enti¬ 
ties.  The  first  several  hundred  lines  of  the  standard  sequence  consist  solely 
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Figure  3.  Structure  of  the  Standard  MAPOL  Sequence. 
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Figure  4.  Multidisciplinary  Optimization  Flow  Chart. 


of  these  variable  declarations.  Tables  4  and  5  show  the  list  of  scalar 
parameters  used  in  the  standard  MAPOL  sequence.  These  parameters,  set  in 
engineering  modules  or  in  the  MAPOL  sequence,  are  used  as  logic  control  flags 
and/or  arguments  to  the  engineering  modules.  The  tables  provide  a  brief 
description  of  each  variable  and  a  list  of  modules  (where  applicable)  that  use 
the  parameter.  For  a  description  of  all  the  variables  used  as  arguments  of 
the  engineering  modules,  the  reader  is  referred  to  the  ASTROS  Programmer's 
Manual.  Note  that  all  of  these  variables  can  be  directly  modified  within  the 
MAPOL  algorithm  at  the  user’s  discretion.  A  discussion  of  those  parameters 
that  the  user  is  most  likely  to  want  to  modify  is  given  in  Subsection  4.4.3, 
but  the  experienced  user  is  free  to  change  any  variable  in  the  MAPOL  sequence. 

Higher  order  variables  fall  into  two  categories:  MAPOL  entities  and 
HIDDEN  entities.  MAPOL  entities  are  those  that  actually  appear  in  the  MAPOL 
sequence  while  HIDDEN  entities  are  those  that  are  declared  but  do  not  subse¬ 
quently  appear  in  the  sequence.  Their  declaration  ensures  that  the  corre¬ 
sponding  data  base  entity  is  created  and  can  be  used  by  engineering  modules 
without  requiring  the  entity  name  to  appear  in  the  argument  list.  HIDDEN 
entities  are  typically  those  that  contain  the  raw  data  needed  by  many  modules; 
e.g.  geometry  data  and  connectivity  data.  The  declarations  of  the  higher 
order  variables  have  been  arranged  to  place  logically  related  entities 
together.  Several  of  the  matrix  entities,  it  should  be  noted,  are  subscripted 
(e.g.  (KLLINV(8) ] ) .  The  subscripted  matrix  entity  allows  the  ASTROS  procedure 
to  perform  multiple  analyses  in  several  boundary  conditions  and  retain  the 
information  needed  to  compute  the  sensitivities  of  the  active  constraints 
retained  from  each  of  these  boundary  conditions.  The  ASTROS  executive  system 
generates  a  name  for  each  subscripted  variable  and  that  name  is  used  by  all 
the  engineering  modules  receiving  the  subscripted  entity  name  as  an  argument. 
The  actual  data  base  entity  name  need  not  be  known.  This  does,  however, 
impose  the  following  restriction:  a  subscripted  entity  may  not  be  used  as  a 
HIDDEN  entity  in  any  engineering  module;  it  must  appear  in  the  calling  list 
for  the  module  because  only  the  executive  system  knows  the  actual  name  of  the 
data  base  entity  corresponding  to  the  current  subscript  value.  In  the  stan¬ 
dard  sequence,  provision  has  been  made  for  up  to  eight  boundary  conditions, 
but  the  user  can  change  the  declared  number  of  subscripts  to  match  the  re¬ 
quired  number  of  boundary  conditions. 
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TABLE  4.  REAL  SCALAR  PARAMETERS  IN  THE  STANDARD  SEQUENCE 


NAME 

MODULES 

DESCRIPTION 

ALPHA 

FSD 

Exponential  move  limit  for  fully  stressed  de¬ 
sign.  (Def  -  0.90) 

BQDP 

BLASTFIT,  others 

Dynamic  pressure  value  used  in  the  current 
nuclear  blast  subcase.  Output  from  BLASTFIT, 
used  subsequently  in  MAPOL  expressions. 

CNVRGLIM 

DESIGN,  FSD 

Convergence  test  limit  specifying  the  maximum 
percent  objective  change  for  the  approximate 
problem  to  be  considered  converged.  (Def-0.50) 

CTL 

ACTCON ,  DESIGN, 
FSD 

Criteria  for  denoting  a  constraint  to  be 
active  in  determining  convergence  in  ACTCON. 

If  value  >  CTL,  the  constraint  is  active.  Set 
in  DESIGN  or  in  FSD. 

CTLMIN 

ACTCON,  DESIGN, 
FSD 

Criteria  for  denoting  a  constraint  to  be 
feasible  in  determining  convergence  in  ACTCON. 

If  maximum  constraint  value  <  CTLMIN,  the  de¬ 
sign  is  feasible.  Set  in  DESIGN  or  in  FSD. 

EPS 

ACTCON 

Criteria  used  in  ACTCON  for  selecting  active 
constraints.  All  constraints  with  values 
greater  than  EPS  will  be  retained. 

(Def  -  -0.10,  also  see  NRFAC) 

FMAX 

GDR1 ,  GDR2 

The  maximum  frequency  value  associated  with  the 
NEIV  eigenvalues  computed  for  dynamic  reduction 
in  the  current  boundary  condition. 

MOVLIM 

DESIGN,  MAKDFV, 
TCEVAL 

A  move  limit  applied  to  the  physical  design 
variable  (V)  for  mathematical  programming  meth¬ 
ods.  The  move  is:  V/MOVLIM  <  V  <  V  *  MOVLIM. 
(Def  -  2.0,  MOVLIM  must  be  >  1.0) 

NRFAC 

ACTCON 

Criteria  used  in  ACTCON  for  selecting  active 
constraints.  At  least  NRFAC  times  NDV  (see 

Table  5)  constraints  will  be  retained. 

(Def  -  3.0,  also  see  EPS) 

QDP 

BDCASE,  others 

Dynamic  pressure  value  used  in  the  current 
steady  aeroelasHc  subcase.  Output  from  BDCASE 
used  subsequently  in  MAPOL  expressions  and 
modules . 

TABLE  5.  INTEGER  SCALAR  PARAMETERS  IN  THE  STANDARD  SEQUENCE 


NOTE:  All  logic  flags  are  zero  if  "false"  and  non-zero  (either 

equal  to  1  or  a  counter)  if  "true." 


NAME 

MODULES 

DESCRIPTION 

AAC 

ABOUND 

Logic  flag  equal  to  one  if  there  are  active 
aeroelastic  constraints  in  the  active  boundary 
condition. 

ABC 

ABOUND 

Logic  flag  equal  to  one  if  the  current  boundary 
condition  is  "active"  for  sensitivity  analysis. 

ADC 

ABOUND,  FREQ SENS 

Logic  flag  equal  to  the  number  of  active 
frequency  constraints  in  the  current  active 
boundary  condition. 

AFC 

ABOUND,  FLUTSENS 

Logic  flag  equal  to  the  number  of  active 
flutter  constraints  in  the  current  active 
boundary  condition. 

BBLAST 

BDCASE 

j 

Logic  flag  equal  to  one  if  there  are  any  nu¬ 
clear  blast  subcases  in  the  current  boundary 
•ondition. 

BC 

N/A 

tfou?idary  condition  loop  counter. 

BDFR 

BDCASE 

Iv-gic  flag  equal  Co  one  if  there  are  any  direct 
frequency  response  subcases  in  the  current 
boundary  condition. 

BDRSP 

BDCASE 

Logic  flag  equal  to  one  if  there  are  either 
transient  or  frequency  response  disciplines 
in  the  current  boundary  condition. 

BDTR 

BDCASE  1 

«ogic  flag  equal  to  one  if  there  are  any  direct 
tijnsient  response  subcases  in  the  current 
boundary  condition. 

BDYN 

BDCASE 

Logic  flag  equal  to  one  if  there  are  any  dy¬ 
namic  analyses ( flutter ,  transient  or  freauency) 
in  the  current  boundary  condition. 

BFLUTR 

BDCASE 

Logic  flag  equal  to  one  if  there  are  any 
flutter  analyses  in  the  current  boundary 
condition. 

BCUST 

BDCASE 

Logic  flag  equal  to  one  if  there  are  any  gust 
loads  for  either  transient  or  frequency  disci¬ 
plines  in  the  current  boundary  condition. 
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TABLE  5.  INTEGER  SCALAR  PARAMETERS  IN  THE  STANDARD  SEQUENCE  (Continued) 


NOTE:  All  logic  flags  are  zero  if  "false"  and  non-zero  (either 
equal  to  1  or  a  counter)  if  "true." 


NAME 

MODULES 

DESCRIPTION 

BLOAD 

BDCASE 

Logic  flag  equal  to  one  if  there  are  any  me¬ 
chanical,  thermal  or  gravity  static  applied 
loads  in  the  current  boundary  condition. 

BMASS 

BDCASE 

Logic  flag  equal  to  one  if  the  disciplines 
within  the  boundary  condition  require  reduction 
of  the  mass  matrix. 

BMFR 

BDCASE 

Logic  flag  equal  to  one  if  there  are  any  modal 
frequency  response  subcases  in  the  current 
boundary  condition. 

BMODES 

BDCASE 

Logic  flag  equal  to  one  if  there  are  disci¬ 
plines  that  require  that  a  normal  modes  analy¬ 
sis  be  performed. 

BMTR 

BDCASE 

Logic  flag  equal  to  one  if  there  are  any  modal 
transient  response  subcases  in  the  current 
boundary  condition. 

BSAERO 

BDCASE 

Logic  flag  equal  to  one  if  there  are  any  steady 
aeroelastic  subcases  in  the  current  boundary 
condition. 

CONVERGE 

ACTCON ,  DESIGN, 
FSD 

Global  optimization  convergence  flag.  If  zero, 
then  not  converged;  if  one,  then  the  approxi¬ 
mate  problem  converged;  if  two,  then  global 
convergence  has  been  reached. 

DDFLG 

DDLOAD 

Logic  flag  equal  to  one  if  the  current  statics 
subcases  contain  design  dependent  (gravity  or 
thermal)  loads. 

FSDFLG 

FSD 

Logic  flag  equal  to  one  if  the  current  itera¬ 
tion  is  to  be  performed  using  the  fully 
stressed  design  option. 

GNORM 

GDR3 

The  sum  of  USET  and  LKSET. 

GSIZE 

IFP,  others 

The  number  of  structural  degrees  of  freedom  in 
the  model.  Output  from  IFP  and  subsequently 
used  in  many  modules. 

GSIZEN 

GDR4 

"GSIZE"  modified  subject  to  dynamic  reduction. 

TABLE  5.  INTEGER  SCALAR  PARAMETERS  IN  THE  STANDARD  SEQUENCE  (Continued) 


NOTE:  All  logic  flags  are  zero  if  "false”  and  non-zero  (either 
equal  to  1  or  a  counter)  if  "true." 


NAME 

MODULES 

DESCRIPTION 

HSIZE 

FLUTTRAN,  OFPEDR, 
REIG 

Number  of  eigenvectors  extracted  by  the  REIG 
module . 

USET 

GDR1,  GDR2 ,  GDR3 , 
GDR4 

Number  of  degrees  of  freedom  in  the  j-set  in 
dynamic  reduction. 

LKSET 

GDR1,  GDR2,  GDR3 , 
GDR4 

Number  of  degrees  of  freedom  in  the  k-set  in 
dynamic  reduction. 

MAXFSD 

FSD 

Parameter  set  in  the  MAPOL  sequence  indicating 
the  number  of  leading  FSD  cycles  to  be  per¬ 
formed  if  FSD  is  selected.  (Def-3,  MAXFSD  <- 
MAXITER) 

MAXITER 

ACTCON 

Parameter  set  in  the  MAPOL  sequence  indicating 
the  maximum  number  of  resizing  cycles  that  are 
to  be  performed.  (Def  -  15) 

MINDEX 

ABOUND,  AEROSENS, 
BDCASE,  PFAERO 

The  index  value  for  the  Mach  number  dependent 
subscripted  steady  aerodynamic  matrices.  Typi¬ 
cally  has  a  value  used  to  select  the  proper 
matrices  for  the  current  boundary  condition. 

NACSD 

ABOUND 

The  number  of  active  stress  and  displacement 
constraints  in  the  current  active  boundary  con¬ 
dition.  Used  to  select  either  the  virtual  load 
or  gradient  method  in  sensitivity  analysis. 

NAE 

ABOUND,  AEROSENS 

The  number  of  aeroelastic  effectiveness  con¬ 
straints  in  the  current  active  boundary  condi¬ 
tion. 

NAERO 

PFAERO 

A  looping  counter  in  PFAERO  that  is  set  on  the 
first  pass.  It  is  equal  to  the  number  of  dis¬ 
tinct  Mach  numbers  appearing  in  aeroelastic 
trim  conditions  in  the  Bulk  Data  packet. 

NAU 

ABOUND,  AEROSENS 

The  number  of  active  static  load  conditions  in 
the  current  active  boundary  condition.  Initial¬ 
ly  includes  pseudo- loads  for  aeroelastic  ef¬ 
fectiveness  constraints.  They  are  then  sub¬ 
tracted  in  the  AEROSENS  module. 
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TABLF  5.  INTEGER  SCALAR  PARAMETERS  IN  THE  STANDARD  SEQUENCE  (Continued) 


NOTE:  All  logic  flags  are  zero  if  "false"  and  non-zero  (either 
equal  to  1  or  a  counter)  if  "true." 


NAME 

MODULES 

DESCRIPTION 

NAUE 

ABOUND,  AEROSENS 

The  number  of  active  pseudo -load  conditions 
associated  with  active  aeroelastic  effective¬ 
ness  constraints. 

NBNDCOND 

SOLUTION 

The  total  number  of  boundary  conditions  in  the 
solution  control  packet.  Equal  to  the  number 
of  optimization  boundary  conditions  plus  the 
number  of  analysis  boundary  conditions. 

NDV 

MAKEST,  others 

The  number  of  global  design  variables  in  the 
design  model.  Set  by  MAKEST  and  used  in  many 
subsequent  modules. 

NEG1 

N/A 

A  variable  having  the  value  of  negative  one 
(-1).  Used  in  FBS  and  GFBS  large  matrix 
utilities . 

NEIV 

GDR1,  GDR2 

An  output  from  GDR1  indicating  the  number  of 
eigenvalues  below  the  maximum  frequency  speci¬ 
fied  for  dynamic  reduction. 

NGDR 

BOUND 

Logic  flag  equal  to  negative  one  if  dynamic 
reduction  is  selected  for  the  current  boundary 
condition. 

NITER 

N/A 

The  current  optimization  iteration  number. 

NMPC 

BOUND,  ABOUND 

Logic  flag  equal  to  the  number  of  degrees  of 
freedom  in  the  multipoint  constraint  set  for 
the  current  boundary  condition. 

NOMIT 

BOUND,  ABOUND 

Logic  flag  equal  to  the  number  of  omitted  de¬ 
grees  of  freedom  in  the  current  boundary  con¬ 
dition. 

NRSET 

BOUND,  ABOUND 

Logic  flag  equal  to  the  number  of  support  de¬ 
grees  of  freedom  in  the  current  boundary  con¬ 
dition. 

NSPC 

BOUND,  ABOUND 

Logic  flag  equal  to  the  number  of  single  point 
constraint  degrees  of  freedom  in  the  current 
boundary  condition. 
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TABLE  5.  INTEGER  SCALAR  PARAMETERS  IN  THE  STANDARD  SEQUENCE  (Concluded) 


NOTE:  All  logic  flags  are  zero  if  "false"  and  non-zero  (either 
equal  to  1  or  a  counter)  if  "true." 


NAME 

MODULES 

DESCRIPTION 

NUMOPTBC 

SOLUTION 

The  number  of  optimization  boundary  conditions 
in  the  solution  control  packet. 

OPSTRAT 

DESIGN,  FSD, 
SOLUTION 

The  optimization  strategy  selected  in  the  so¬ 
lution  control. 

SYM 

BDCASE 

A  control  flag  denoting  whether  the  symmetric 
(SYM-1)  or  antisymmetric  (SYM--1)  steady  aero- 
elastic  matrices  are  to  be  used  in  the  current 
boundary  condition. 

TRMTYP 

ABOUND,  BDCASE, 
others 

A  control  flag  denoting  the  type  of  trim  se¬ 
lected  for  the  current  steady  aeroelastic  sub¬ 
cases.  Output  from  either  BDCASE  (analysis) 
or  ABOUND  (sensitivity)  and  used  in  many  sub¬ 
sequent  modules . 

TRMTYP  -  0  no  trim 

TRMTYP  -  1  lift  only  trim 

TRMTYP  -  2  lift/pitch  trim 

4.4.2  The._gplyitiop  Algorithm 

Finite  element  analysis,  which  forms  the  core  of  the  ASTROS  system, 
requires  the  manipulation  of  large  matrices.  The  MAPOL  control  language  was 
designed  with  this  requirement  in  mind  and,  therefore,  is  able  to  directly 
support  the  manipulation  of  matrices.  Consequently,  the  majority  of  the  MAPOL 
sequence  consists  of  matrix  equations.  The  algorithmic  nature  of  the  MAPOL 
syntax  allows  the  reader  to  follow  these  matrix  operations  fairly  easily,  and 
the  notation  roughly  follows  that  used  in  the  Theoretical  Manual.  Therefore, 
the  focus  of  this  section  will  be  the  description  of  modules  called  by  the 
MAPOL  sequence. 

There  are  a  number  of  engineering  and  utility  modules  called  to 
perform  tasks  associated  with  the  several  analysis  disciplines  supported  by 
the  ASTROS  system.  Section  4.4. 2.1  lists  the  modules  defined  to  the  ASTROS 
executive  system  and  provides  a  brief  description  of  each.  Not  all  of  these 


modules  appear  in  the  standard  solution  sequence,  but  are  included  in  the 
table  to  ensure  its  completeness  and  usefulness  in  modifying  the  standard 
sequence.  The  use  of  these  modules  is  discussed  in  raoro  detail  in  the 
section  on  modifying  the  standard  MAPOL  sequence  and  are  more  fully  documented 
in  the  Programmer's  Manual.  Brief  descriptions  of  the  remaining  segments  of 
the  standard  algorithm  follow.  Coupled  with  the  inherent  readability  of  MAPOL 
syntax,  they  provide  a  reasonably  complete  picture  of  the  flow  through  the 
standard  sequence. 

4. 4. 2.1  MAPOL  Engineering  and  Utility  Modules 

This  section  contains  a  brief  description  of  each  of  the  MAPOL 
addressable  modules  defined  to  the  ASTROS  executive  system.  The  intrinsic 
mathematical  functions  of  the  MAPOL  language  are  not  included.  In  some  cases, 
the  MAPOL  calling  list  for  particular  modules  has  optional  arguments  for  extra 
printed  output  or  other  special  actions.  Where  these  optional  arguments  do 
not  appear  in  the  standard  sequence,  the  arguments  are  shown  in  lower  case 
letters . 


MAPOL  ENGINEERING  MODULE:  ABOUND 

Purpose:  Generates  flags  for  the  current  boundary  condition 

during  the  sensitivity  calculation.  These  are  then 
returned  to  the  executive  sequence  to  direct  the 
execution  of  the  required  sensitivity  analyses. 

Calling  Sequence: 

CALL  ABOUND  (  BC ,  ABC,  PCA,  NAU,  NACSD,  (PGA],  ADC,  AFC,  AAC, 
TRMTYP ,  MINDEX,  NAE,  NAUE,  PAE,  NMPC,  NSPC,  NOMIT, 
NRSET,  NGDR,  (UG(BC)]  ); 


MAPOL  ENGINEERING  MODULE:  ACTCON 

Purpose:  Determines  whether  the  design  task  has  converged.  If 

the  optimization  has  not  converged,  this  module  selects 
which  constraints  are  to  be  included  in  the  current 
redesign.  On  termination  or  print  request,  this  routine 
computes  the  values  of  the  local  design  variables. 

Calling  Sequence: 

CALL  ACTCON  (  NITER,  MAXITER,  NRFAC ,  NDV,  EPS,  CONVERGE,  CTL, 
CTLMIN,  [AMAT]  ) ; 
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AEROSENS 


Purpose:  Computes  the  sensitivities  of  active  strength  con¬ 

straints  and/or  aeroelastic  effectiveness  constraints 
for  active  steady  aeroelastic  optimization  boundary 
conditions . 

Calling  Sequence: 

CALL  AEROSENS  (BC,  TRMTYP,  MINDEX,  NDV,  NAU,  NAE,  NAUE ,  PAE,  [DK1V] , 

[ DRHS ] ,  [K1112(BC>],  [K21(BC)],  [RHS(BC)],  [LHS(BC)], 

[ PAR ( BC ) ] ,  [DUAV],  [PGA],  [ DDELDV ] ,  [AMAT]  ); 


Purpose:  Computes  the  discipline  dependent  unsteady  aerodynamic 

matrices  for  flutter,  gust  and  blast  analyses. 


Calling  Sequence : 

CALL  AMP  (  [AJJTL] ,  [D1JK] ,  [D2JK] ,  [SKJ],  [QKKL] ,  [QKJL]  , 
[QJJL],  [ajjdc],  print  ); 


BDCASE 


Purpose:  Generates  flags  for  the  current  boundary  condition 

during  the  analysis  phase.  These  are  then  returned  to 
the  executive  sequence  to  direct  the  execution  of  the 
required  analyses. 


Calling  Sequence: 

CALL  BDCASE  (  BC,  BLOAD,  BMASS ,  BMODES ,  BSAERO ,  QDP,  MINDEX,  SYM, 
TRMTYP,  BFLUTR ,  BDYN ,  BDRSP,  BDTR,  BMTR,  BDFR,  BMFR, 
BGUST,  BBLAST  ); 


BLASTDRV 


Purpose:  Performs  the  response  of  an  aircraft  to  a  nuclear 

blast.  Computes  modal  displacements,  velocities  and 
accelerations . 


Calling  Sequence: 

CALL  BLASTDRV  (  BC,  [GENM] ,  [GENK] ,  [GENFA] ,  [GENQL] ,  [DELB], 
[URDB] ,  [DWNWSH],  [SLPMOD] ,  [ELAS],  [UBLASTI ] ) ; 


BLASTFIT 


Purpose:  Computes  the  interpolated  time  domain  steady  state  and 

time  dependent  unsteady  aerodynamic  influence  coeffi¬ 
cients  for  blast  analyses. 


Calling  Sequence: 

CALL  BLASTFIT  (  BC,  [QJJL],  [MATTR] ,  [MATSS]  ) 
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MAPOL  ENGINEERING  MODULE:  BLASTRIM 


Purpose:  Performs  a  trim  analysis  of  an  aircraft  in  order  to 

establish  initial  conditions  for  a  nuclear  blast 
response  calculation. 

Calling  Sequence: 

CALL  BLASTRIM  (  BC,  [DELM] ,  (MRR(BC) ) ,  [URDB] ,  [DELB]  ); 

MAPOL  ENGINEERING  MODULE:  BOUND 

Purpose:  Returns  flags  to  the  MAPOL  sequence  that  define  the 

matrix  reduction  path  for  the  current  boundary  condi¬ 
tion. 

Calling  Sequence: 

CALL  BOUND  (BC,  NMPC,  NSPC,  NOMIT,  NRSET,  NGDR  ); 

MAPOL  ENGINEERING  MODULE:  DCEVAL 

Purpose:  Evaluates  displacement  constraints  in  the  current 

boundary  condition. 

Calling  Sequence: 

CALL  DCEVAL  (  BC,  [UG(BC) ]  ); 


MAPOL  ENGINEERING  MODULE:  DDLOAD 

Purpose:  Computes  the  sensitivities  of  design  dependent  loads 

for  active  boundary  conditions. 

Calling  Sequence: 

CALL  DDLOAD  (  NDV ,  GSIZE,  BC ,  DDFLG,  [PGA],  [DPVJ]  ); 


MAPOL  ENGINEERING  MODULE:  DESIGN 

Purpose:  Performs  redesign  by  math  programming  methods  based  on 

the  current  set  of  active  constraints  and  constraint 
sensitivities . 

Calling  Sequence: 

CALL  DESIGN  (  CONVERGE,  MOVLIM,  CNVRGLIM,  CTL,  CTLMIN,  OPSTRAT, 
NUMOPTBC ,  [AMAT],  print  ); 
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MAPOL  ENGINEERING  MODULE:  DMA 


Purpose:  Assembles  the  direct  and/or  modal  stiffness,  mass  and/ 

or  damping  matrices  including  extra  point  degrees  of 
freedom  for  dynamic  analysis  disciplines. 

Calling  Sequence: 

CALL  DMA  (  BC,  GSIZE,  [MAA] ,  [KAA] ,  [TMN(BC) ] ,  [GSUBO(BC) ] , 
NGDR,  LAMBDA,  [PHIA],  [MDD] ,  [BDD] ,  [ KDDT ] ,  [KDDF] , 

[MHH(BC) ] ,  [ BHH ] ,  [KHHT] ,  (KHHF(BC) ]  ); 


MAPOL  ENGINEERING  MODULE:  DYNLOAD 

Purpose:  Assembles  the  direct  and/or  modal  time  and/or  frequency 

dependent  loads  including  extra  point  degrees  of 
freedom  for  dynamic  response  disciplines. 

Calling  Sequence: 

CALL  DYNLOAD  (  BC,  GSIZE,  [ TMN ( BC ) ] ,  [GSUBO(BC)],  NGDR,  [PHIA], 
[QHJL] ,  [PDT] ,  [PDF]  ); 


MAPOL  ENGINEERING  MODULE:  DYNRSP 

Purpose:  computes  the  direct  or  modal  displacements,  velocities 

and  accelerations  for  transient  and  frequency 

analyses . 

Calling  Sequence: 

CALL  DYNRSP  (BC,  [MDD],  [BDD],  [KDDT],  [KDDF],  [MHH(BC) ] ,  [BHH], 
[KHHT],  [KHHF(BC) ] ,  [PDT],  [PDF],  [QHHL(BC) ] ,  [UTRANA] , 
[UFREQA] ,  [UTRANI],  [UFREQI ] ,  [UTRANE] ,  [UFREQE]  ); 


MA-POL  ENGINEERI_NG.MODULE:  EDR 

Purpose:  Computes  the  stresses,  strains,  grid  point  forces  and 

strain  energies  for  elements  selected  for  output  for 
the  current  boundary  condition. 

Calling  Sequence: 

CALL  EDR  (  NUMOPTBC ,  BC,  NITER,  NDV ,  GSIZE,  EOSUMMRY ,  EODISC, 
[UG(BC) ] ,  [UG(BC) ] ,  [blug],  [UTRANG] ,  [UFREQG] , 
[ PHIG(BC) ]  ); 


MAPOL  ENGINEERING  MODULE:  EMAl 


Purpose:  Assembles  the  element  stiffness  and  mass  matrices 

(stored  in  the  KEUi  and  HELM  entities)  into  the  design 
sensitivity  matrices  DKVI,  DMVI. 

Calling  Sequence: 

CALL  EMAl  (  NDV,  GMKCT,  DKVI,  GMMCT,  DMVI  ); 


MAPOL  ENGINEERING  MODULE:  EMA2 

Purpose:  Assembles  the  element  stiffness  and  mass  matrix  sensi¬ 

tivities  (stored  in  the  DKVI  and  DMVI  entities)  into 
the  global  stiffness  and  mass  matrices  for  the  current 
design  iteration. 

Calling  Sequence: 

CALL  EMA2  (  GSIZE,  [KGG] ,  [MGG] ,  niter  ); 


MAPOL  ENGINEERING  MODULE:  EMG 

Purpose:  Computes  the  element  stiffness,  mass,  thermal  load  and 

stress  component  sensitivities  for  all  structural 
elements . 

Calling  Sequence: 

CALL  EMG  (  NDV,  GSIZE  ); 


MAPOL  UTILITY  MODULE:  EXIT 

Purpose:  Terminates  the  execution  of  the  MAPOL  sequence.  Useful 

to  terminate  modified  MAPOL  sequences. 

Calling  Sequence: 

CALL  EXIT; 


MAPOL  ENGINEERING  MODULE :  FCEVAL 

Purpose:  Evaluates  the  current  value  of  all  frequency  con¬ 

straints  . 

Calling  Sequence: 

CALL  FCEVAL  (  BC,  LAMBDA  ); 
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MAPOL  ENGINEERING  MODULE:  FLUTSENS 


Purpose:  Computes  the  sensitivities  of  active  flutter  con¬ 

straints  in  the  current  active  boundary  condition. 

Calling  Sequence: 

CALL  FLUTSENS  (  BC,  GSIZE,  NDV ,  [QHHL(BC) ) ,  [ MHH ( BC ) ) ,  [KHHF(BC) ] , 

( PHIG(BC) ] ,  (AMAT]  ) ; 


MAPOL  ENGINEERING  MODULE:  FLUTTRAN 

Purpose:  Performs  flutter  analyses  in  the  current  boundary 

condition  and  evaluates  any  flutter  constraints  if  it 
is  an  optimization  boundary  condition  with  applied 
flutter  constraints. 

Calling  Sequence: 

CALL  FLUTTRAN  (  BC,  (QHHL(BC) ) ,  LAMBDA,  HSIZE,  (MHH(BC) ] ,  [KHHF(BC) ] , 
print  ); 


MAPOL  ENGINEERING  MODULE:  FREDUCE 

Purpose:  Reduces  the  f-set  stiffness,  mass  and/or  loads  matrix 

to  the  a-set  if  there  are  omitted  degrees  of  freedom. 

Calling  Sequence: 

CALL  FREDUCE  (  (KFF] ,  ( PF] ,  [PFOA(BC)),  bsaero,  (KOOINV(BC) ] , 

(koou(bc) ] ,  (kao(bc) ) ,  [GSUBO(BC)],  [KAA] ,  [PA],  [ PO ] ) ; 


MAPOL  EWIMEERINC  MODULE :  FREQS ENS 

Purpose:  Computes  the  sensitivities  of  active  frequency  con¬ 

straints  in  the  current  active  boundary  condition. 

Calling  Sequence: 

CALL  FREQS ENS  (  BC,  ADC,  NDV,  (PHIG(BC)],  [AMAT]  ); 


MAPOL  ENGINEERING  MODULE:  FSD 

Purpose:  Performs  redesign  by  a  fully  stressed  design  method 

(Stress  Ratio  Algorithm)  based  on  the  set  of  applied 
stress  constraints.  All  other  applied  constraints  are 
ignored. 

Calling  Sequence: 

CALL  FSD  (  NDV,  NITER,  MAXFSD,  OPSTRAT,  ALPHA,  FSDFLG ,  CNVRGLIM, 
CONVERGE,  CTL,  CTLMIN  ); 
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MAPOL  ENGINEERING  MODULE:  GDR1 


Purpose:  Computes  the  shifted  stiffness  matrix  and  the  rigid 

body  transformation  matrix  [GGO]  to  be  used  in  Phase  2 
of  Generalized  Dynamic  Reduction. 

Calling  Sequence: 

CALL  GDR1  (  (K00],  (MOO],  [KSOO]  ,  [GGO],  LKSET,  USET,  NEIV, 

NMAX,  BC  ); 


MAPOL  ENGINEERING  MODULE:  GDR2 

Purpose:  Computes  the  orthogonal  basis  [PHIOK]  for  the  general 

Krylov  subspace  to  be  used  in  Phase  3  of  Generalized 
Dynamic  Reduction. 

Calling  Sequence: 

CALL  GRD2  ([LSOO],  (MOO],  [PHIOK],  LKSET,  USET,  NEIV,  NMAX,  BC) ; 


MAPOL  ENGINEERING  MODULE:  GDR3 

Purpose:  Computes  the  transformation  matrix  (GSUBO]  for  General¬ 

ized  Dynamic  Reduction. 

Calling  Sequence: 

CALL  GDR3  (  [KOO] ,  [KOA] ,  [ MGG ] ,  [PHIOK],  (TMN(BC) ] ,  [GGO], 

(PGMN(BC)],  [ PNSF(BC) ] ,  [PFOA(BC)],  [GSUBO(BC)],  LKSET, 
USET,  NOMIT,  NRSET ,  GNORM,  BC  ); 


MAPOL  ENGINEERING  MODULE:  GDR4 

Purpose:  Computes  transformations  between  displacement  sets 

useful  for  data  recovery  from  Generalized  Dynamic 
Reduction . 

Calling  Sequence: 

CALL  GDR4  (  BC,  GSIZE,  GSIZEN,  LKSET,  USET,  NUMOPTBC,  NBNDCOND, 
(GDRGO(BC)],  not  used  ,  not  used,  not  used,  not  used, 
not  used,  (PARL(BC)]  ); 


MAPOL  ENGINEERING  MODULE:  GREDUCE 

Purpose:  Reduces  the  symmetric  g-set  stiffness,  mass  or  loads 

matrix  to  the  n-set  if  there  are  multipoint  constraints 
in  the  boundary  condition. 

Call ing  Sequence : 

CALL  GREDUCE  (  [KGG] ,  [pg],  [ PGMN ( BC ) ] ,  [ TMN ( BC ) ] ,  [ KNN] ,  [pn]  ); 
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MAPOL  ENGINEERING  MODULE:  GTLOAD 


Purpose:  Assembles  the  current  static  applied  loads  matrix  for 

any  statics  subcases  in  the  current  boundary  condition 
from  the  constant  simple  load  vectors  and  the  design 
dependent  load  sensitivities. 

Calling  Sequence: 

CALL  GTLOAD  (  BC,  GSIZE,  NLOADS ,  [PG]  ); 

MAPOL  ENGINEERING  MODULE:  IFP 

Purpose:  Reads  the  Bulk  Data  File  and  loads  the  input  data  into 

relations.  Computes  the  external  coordinate  system 
transformation  matrices  and  creates  the  basic  grid 
point  data. 

Calling  Sequence: 

CALL  IFP  (  GSIZE,  sort,  echo  ); 


MAPOL  ENGINEERING  MODULE:  INERTIA 

Purpose:  Computes  the  rigid  body  accelerations  for  static 

analyses  vith  inertia  relief. 

Calling  Sequence: 

CALL  INERTIA  (  (LHS(BC)],  (RHS(BC)],  [AR]  ); 


MAPOL  EWWEEMPC  MODULE:  LODGEN 

Purpose:  Assembles  the  simple  load  vectors  and  simple  load 

sensitivities  for  all  applied  loads  in  the  Bulk  Data 
File. 

Calling  Sequence: 

CALL  LODGEN  (  GSIZE  ) ; 


MAPOL  ENGINEERING  MODULE:  MAKDFU 

Purpose:  Assembles  the  sensitivities  to  the  displacements  of 

active  stress  and  displacement  constraints  in  the 
current  active  boundary  condition. 

Calling  Sequence: 

CALL  MAKDUF  (  BC,  GSIZE,  [ DFDU ]  ); 
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MAPOL  ENGINEERING  MODULE:  MAKDFV 


Purpose:  Assembles  the  sensitivities  of  active  thickness  con¬ 

straints  . 

Calling  Sequence : 

CALL  MAKDFV  (  NDV,  [AMAT] ,  MOVLIM  ); 


MAPOL  ENGINEERING  MODULE:  MAKDVU 

Purpose:  Multiplies  the  stiffness  or  mass  design  sensitivities 

by  the  active  displacements  or  accelerations. 

Calling  Sequence: 

CALL  MAKDVU  (  NDV,  [UGA] ,  [DKUG] ,  GMKCT,  DKVI  ); 


MAPOL  ENGINEERING  MODULE:  MAKEST 

Purpose:  Generates  the  element  summary  relational  entities  for 

all  structural  elements.  Determines  the  design  varia¬ 
ble  linking  and  generates  sensitivities  for  any  thick¬ 
ness  constraints. 

Calling  Sequence: 

CALL  MAKEST  (  NDV  ) ; 


MAPOL  ENGINEERING  MODULE:  MKAMAT 

Purpose:  Assembles  the  constraint  sensitivity  matrix  from  the 

sensitivity  matrices  formed  by  MAKDFU  and  the  sensitiv¬ 
ities  of  the  displacements  for  active  static  load 
conditions  in  the  current  active  boundary  condition. 

Calling  Sequence: 

CALL  MKAMAT  (  [AMAT],  [DFDUF] ,  [DUFV] ,  PCA,  [PGA]  ) ; 


MAPOL  ENGINEERING  MODULE:  MKUSET 

Purpose:  Generates  the  structural  set  definition  entity  USET  for 

each  boundary  condition  and  forms  the  partitioning 
vectors  and  transformation  matrices  used  in  matrix 
reduction. 

Calling  Sequence: 

CALL  MKUSET  (BC,  GSIZE,  [YS(BC)],  [TMN(BC) ] ,  [ PGMN(BC) ] , 

[PNSF(BC) ] ,  [ PFOA(BC) ] ,  [PARL(BC) ]  ); 
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MAPOL  ENGINEERING  MODULE:  NREDUCE 


Purpose:  Reduces  the  symmetric  n-set  stiffness,  mass  or  loads 

matrix  to  the  f-set  if  there  are  single  point  con¬ 
straints  in  the  boundary  condition. 

Calling  Sequence: 

CALL  NREDUCE  (  [KNN] ,  [PN],  [PNSF(BC)],  [YS(BC)],  [ KFF ] ,  [ KFS ] , 

[KSSj,  [PF]  ); 


MAPOL  UTILITY  MODULE:  NULLMAT 

Purpose:  Breaks  data  base  equivalences  from  previous  boundary 

conditions . 

Calling  Sequence: 

CALL  NULLMAT  (  [matrix  1],  [matrix  2],  ...  [matrix  10]  ); 


MAPOL  ENGINEERING  MODULE:  OFPDISP 

Purpose:  Prints  selected  displacements,  velocities  and/or 

accelerations  from  any  analyses  in  the  current  boundary 
condition. 

Calling  Sequence: 

CALL  OFPDISP  (  NUMOPTBC ,  BC,  NITER,  GSIZE,  [UG(BC)],  [AG(BC) ] , 
TRMTYP ,  [UG(BC) ] ,  [AG(BC) ] ,  [blug] ,  [blue],  [UTRANG] , 
[UTRANE],  [UFREQG] ,  [UFREQE] ,  LAMBDA,  [PHIG(BC)]  ); 


MAPOL  ENGINEERING  MODULE:  OFPEDR 

Purpose:  Prints  selected  element  stress,  strain,  force  and/or 

strain  energies  from  any  analyses  in  the  current 
boundary  condition. 

Calling  Sequence: 

CALL  OFPEDR  (  BC,  HSIZE,  NITER,  TRMTYP  ); 


MAPOL  ENGINEERING  MODULE:  0FPL0AD 

Purpose:  Prints  selected  applied  external  loads  from  any  analy¬ 

ses  in  the  current  boundary  condition. 

Calling  Sequence: 

CALL  0FPL0AD  (  NUMOPTBC,  BC,  NITER,  C1IZE,  [PG] ,  TRMTYP,  QDP, 
[GTKG] ,  [AIRFRC(MINDEX) ] ,  [DELTA]  ); 
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MAPOL  ENGINEERING  MODULE:  PFAERO 


Purpose:  Performs  preface  aerodynamic  processing  for  both  steady 

and  unsteady  aerodynamics  and  aerostructural  interpola¬ 
tion. 

Calling  Sequence: 

CALL  PFAERO  (GSIZE,  (AICMAT(MINDEX) ] ,  (AAICMAT(MINDEX) ] , 

(AIRFRC(HINDEX) ] ,  MINDEX,  NAERO,  [GTKG] ,  [GSTKG] , 
[UGTKG] ,  [AJJTL] ,  (D1KJ),  [D2JK] ,  [SKJ],  print  ); 


MAPOL  ENGINEERING  MODULE:  PFBULK 

Purpose:  Performs  a  number  of  preface  operations  to  form  addi¬ 

tional  collections  of  data.  The  following  entities  are 
created  or  modified  in  this  module: 


TEMP , TEMPD 

to 

form 

GRIDTEMP 

DCONDSP 

to 

form 

DC  ENT 

DLONLY 

to 

form 

UDLOLY 

FREQ , FREQl 
FREQ2 

to 

form 

FREQL 

DMIG 

to 

form 

named  entity 

TF 

to 

form 

TFDATA 

IC 

to 

form 

ICDATA 

TSTEP 

to 

form 

OTL 

SOLUTION 

CONTROL 

to 

form 

EOSUMMRY,  EODISC  and  GPFELEM 

Calling  Sequence: 

CALL  PFBULK  (  GSIZE,  EOSUMMRY ,  EODISC,  GPFELEM  ); 


MAPOL  ENGINEERING  MODULE:  QHHLGEN 

Purpose:  Computes  the  discipline  dependent  unsteady  aerodynamic 

matrices  for  flutter,  gust  and/or  blast  analyses  in  the 
modal  structural  system. 

Calling  Sequence: 

CALL  QHHLGEN  (  BC,  [QKKL] ,  [QKJL] ,  [UGTKA] ,  [PHIA],  [PHIKH], 
(QHHL(BC) ] ,  [QHJL]  ) ; 


MAPOL  UTILITY  MODULE:  RECEND 

Purpose:  Terminates  setting  conditions  on  a  MAPOL  relational 

access . 

Calling  Sequence: 

CALL  RECEND  (  Relation  name  ); 


MAPOL  ENGINEERING  MODULE:  RECOVA 


Purpose:  Recovers  the  f-set  displacements  or  accelerations  if 

there  are  omitted  degrees  of  freedom. 

Calling  Sequence: 

CALL  RECOVA  (  [UA] ,  [PO] ,  (GSUBO(BC)],  nrset,  [aa] ,  [ifm(bc)], 
bsaero,  (KOOINV(BC) ] ,  [koou(bc)],  [PFOA(BC)],  [UF]  ); 


MAPOL  ENGINEERING  MODULE:  REIG 

Purpose:  Computes  the  eigenvalues  and  eigenvectors  of  the  system 

as  directed  by  the  boundary  METHOD  selection. 

Calling  Sequence: 

CALL  REIG  (  BC,  [KAA] ,  [MAA] ,  (mrr(bc)],  [d(bc)],  LAMBDA,  [PHIA] , 
[Mil] ,  HSIZE  ) ; 


MAPOL  UTILITY  MODULE:  RELCND 

Purpose :  Sets  conditions  on  attribute  values  for  MAPOL  retrieval 

of  relational  entities. 

Calling  Sequence: 

CALL  RELCND  (  Relation  name,  Attribute  name,  Operator,  value  ) 


MAPOL  UTILITY  MODULE :  RELADD 

Purpose:  Adds  a  tuple  to  an  entity  opened  with  RELUSE. 

Calling  Sequence: 

CALL  RELADD  (  Relation  name  ); 


MAPQL_yiILHY  MODULE:  RELEND 

Purpose:  Closes  an  entity  opened  from  the  MAPOL  sequence  using 

RELUSE. 

Calling  Sequence: 

CALL  RELEND  (  Relation  name  ) ; 


MAPOL  UTILITY  MODULE:  RELGET 

Purpose:  Retrieves  a  relational  tuple  into  execution  memory  for 

a  relation  opened  for  use  in  the  MAPOL  sequence. 

Calling  Sequence: 

CALL  RELGET  (  Relation  name,  Status  ); 
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RELUPD 


Purpose:  Performs  a  relational  update  from  execution  memory  of  a 

tuple  retrieved  using  RELGET. 

Calling  Sequence: 

CALL  RELUPD  (  Relation  name) ; 


MAPOL  UTILITY  MODULE:  RELUSE 

Purpose:  Opens  a  relational  entity  for  access  from  the  executive 

sequence . 

Calling  Sequence: 

CALL  RELUSE  (  Relation  name,  Number  of  tuples,  Status  ); 
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MAPOL  ENGINEERING  MODULE:  SAERO 

Purpose:  Solves  the  trim  equation  for  steady  aeroelastic  trim 

analyses.  Computes  the  rigid  and  flexible  stability 
coefficients  for  steady  aeroelastic  analyses  and  the 
aerodynamic  effectiveness  constraints  for  optimization. 

Calling  Sequence: 

CALL  SAERO  (  BC,  [LHS(BC)],  [RHS(BC)],  [AR] ,  [DELTA],  NRHS ,  [P2] , 
[MRR(BC) ]  ); 


MAPOL  ENGINEERING  MODULE:  SCEVAL 

Purpose:  Computes  the  stress  and/or  strain  constraint  values  for 

the  statics  or  steady  aeroelastic  trim  analyses  in  the 
current  boundary  condition. 

Calling  Sequence: 

CALL  SCEVAL  (  BC ,  [GLBSIG] ,  [UG(BC)],  TRMTYP,  print  ); 

MAPOL  ENGINEERING  MODULE:  SOLUTION 

Purpose:  Interprets  the  solution  control  packet,  forms  the  CASE 

entity  and  outputs  certain  key  parameters  to  the 
executive  sequence . 

Calling  Sequence: 

CALL  SOLUTION  (  NUMOPTBC,  NBNDCOND,  OPSTRAT  ); 
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MAPOL  ENGINEERING  MODULE:  TCEVAL 


Purpose:  Computes  the  current  values  of  thickness  constraints 

for  this  optimization  iteration.  Flushes  certain 
entities  for  reuse  in  the  current  iteration  including: 

CONST,  LAMBDA,  CLAMBDA 

Calling  Sequence: 

CALL  TCEVAL  (  MOVLIM  ) ; 


MAPOL  UTILITY  MODULE:  USETPRT 

Purpose:  Prints  the  structural  set  definition  table  from  the 

USET  entity  for  the  specified  boundary  condition. 

Calling  Sequence: 

CALL  USETPRT  (  BC  ) ; 


MAPOL  UTILITY  MODULE:  UTGPRT 

Purpose:  Prints  several  specific  matrix  entities  in  an  inter¬ 

pretable  form.  The  entities  supported  are: 

[DRUG],  [ DMUG ] ,  {DPVJ],  [DUG],  [DPGV] ,  [DU  IV] 

and 

[DPTHVI ] ,  [ DPGRVI ] 

and 

[PG] 

and 

[ DFDU ] 

Calling  Sequence: 

CALL  UTGPRT  (  BC,  [matl] ,  [mat2],  ...  [matlO]  ); 


MAPOL  UTILITY  MODULE:  UTMPRT 

Purpose:  To  print  any  matrix  entity.  There  are  two  "methods:" 

(1)  method  -  0,  expand  each  matrix  column  to  contain 

one  string  starting  with  the  first 
non- zero  term  and  ending  with  the  last 

(2)  method  >  0,  print  only  the  non-zero  terms  in  each 

column. 


Calling  Sequence: 

CALL  UTMPRT  (  method,  [matl],  [mat2],  ...  [matlO]  ); 


Purpose : 


To  print  any  relational  entity.  Only  the  first  twelve 
attributes  are  printed  and  character  attributes  must  be 
eight  characters  in  length  or  they  will  be  ignored. 


Calling  Sequence: 

CALL  UTRPRT  (  rell,  rel2,  ...  rellO  ); 


MAPOL  UTILITY  MODULE 
Purpose : 


UTUPRT 


To  print  any  unstructured  entity.  There  are  four 
"types"  supported: 

(1)  type  <  0  prints  only  the  record  length  (in  single 

precision  words)  of  each  record  in  the 
entity. 

(2)  type  -  0  prints  each  record  using  an  integer 

format . 

(3)  type  -  1  prints  each  record  using  a  real  single 

precision  format. 

(4)  type  -  2  prints  each  record  using  a  double  preci¬ 

sion  format. 


Calling  Sequence: 

CALL  UTUPRT  (  UNSTRUCT,  type  ); 


MAPOL  ENGINEERING  MODULE:  YSMERGE 

Purpose:  A  special  purpose  merge  utility  for  merging  YS-like 

vectors  (vectors  of  enforced  displacements)  into 
matrices  for  data  recovery.  If  the  YS  argument  is 
blank,  null  vectors  are  merged.  If  DYNFLG  is  non-zero 
the  matrix  UF  is  assumed  to  have  the  form  of  a  dynamic 
response  matrix  (3  columns  per  subcase:  displacement, 
velocity  and  acceleration). 

Calling  Sequence: 

CALL  YSMERGE  (  [UN],  [ys(bc)],  [UF] ,  [PNSF(BC)],  dynflg  ); 


4. 4. 2. 2  The  Preface  Segment 

In  the  context  of  optimization,  it  is  obvious  that  invariant  data 
should  be  computed  only  once  and  reused  subsequently  for  each  iteration.  This 
is  the  underlying  principle  involved  in  the  determination  of  which  modules 
constitute  preface  modules.  In  each  instance,  the  data  generated  are 
invariant  with  respect  to  the  design  variables. 


The  preface  segment  begins  with  a  call  to  the  solution  control  inter¬ 
preter  to  determine  the  number  and  types  of  analyses  to  be  performed.  The 
input  file  processor  (IFP)  is  then  called,  followed  by  modules  to  form  basic 
data  collections  required  for  all  analyses.  The  element  connection  data  and 
element  matrices  are  then  formed  as  well  as  the  simple  loads  and  load  sensi¬ 
tivities.  If  any  aerodynamic  analyses  are  requested  in  the  solution  control, 
the  PFAERO  and  AMP  modules  are  called  to  create  the  aerodynamic  matrices 
required  for  the  aeroelastic  analysis. 

4.4. 2. 3  The  Analvsis/Qptimization  Segments 

The  remainder  of  the  MAPOL  algorithm  consists  of  the  optimization  and 
analysis  segments.  Any  particular  boundary  condition  is  either  an 
optimization  boundary  condition  (implying  that  the  quantities  computed  in  the 
disciplines  selected  in  the  solution  control  are  constrained  and  that  the 
structure  is  to  be  optimized  subject  to  those  constraints)  or  an  analysis 
boundary  condition.  The  design  of  the  ASTROS  system  requires  that  all 
optimization  boundary  conditions  precede  any  analysis  boundary  conditions. 
The  analysis  segment  (labeled  the  "final  analysis")  is  intended  to  follow  an 
optimization  with  analyses  in  disciplines  whose  output  values  are  not  con¬ 
strained  but  are  of  interest  to  the  designer.  It  also  provides  the  user  with 
an  opportunity  to  view  additional  output  not  desired  within  the  optimization 
loop.  Finally,  the  analysis  segment  can  be  used  on  a  standalone  basis  to 
perform  any  desired  analyses. 


Both  the  optimization  and  analysis  segments  begin  with  a  loop  on  the 
number  of  boundary  conditions.  They  differ  only  in  the  respect  that  the 
analysis  segment  does  not  have  calls  to  constraint  evaluation  modules  and  the 
optimization  segment  has  a  convergence  test  outside  the  analysis  boundary 
condition  loop.  The  first  step  in  these  loops  is  to  assemble  the  global 
stiffness  and/or  mass  matrices  and,  if  needed,  the  global  loads  matrix.  If 
the  boundary  condition  includes  a  steady  aerodynamic  analysis,  the  appropriate 
matrices  (computed  in  the  preface  segment)  are  retrieved  for  use  within  the 
analysis  phase.  Following  these  tasks,  there  are  several  BLOCK  IF  statements 
on  the  various  dependent  structural  sets.  In  executing  each  block,  the 
required  matrix  partitions  and  reductions  are  performed.  Once  the  reduced 
matrices  have  been  obtained  for  the  analyses  being  performed  within  the  loop, 


the  lowest  level  response  quantities  (e.g.  displacements,  eigenvalues,  etc.) 
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are  computed.  Following  the  solution,  the  execution  proceeds  through  another 
group  of  dependent  set  BLOCK  IF's  to  recover  the  solution  vectors  to  the 
global  set.  At  this  point,  the  analysis  segment  is  completed  with  calls  to 
the  output  file  processor  modules  to  compute  and  output  high  level  response 
quantities  (e.g.  stresses). 

In  the  optimization  phase  of  the  optimization  segment,  the  ACTCON 
module  determines  the  status  of  the  global  convergence  flag  CONVERGE  and,  if 
the  optimization  is  not  complete,  the  redesign  task  is  performed.  Two 
redesign  methods  are  supported  by  the  standard  sequence  and  selected  through 
the  Solution  Control.  If  the  option  for  Fully  Stressed  Design  (FSD)  is 
selected,  the  redesign  is  performed  in  the  FSD  modules.  The  alternative 
method  employs  mathematical  programming  methods  that  require  sensitivity 
information.  “in  this  case,  the  sensitivities  of  the  active  constraints 
(chosen  by  ACTCON  based  on  the  NRFAC  and  EPS  parameters)  are  computed. 

The  sensitivities  of  the  active  constraints  which  are  explicit  func¬ 
tions  of  the  design  variables  are  computed  first.  Then  the  second  boundary 
condition  loop  within  the  optimization  segment  begins.  The  ABOUND  routine 
determines  the  types  of  active  constraints  in  each  boundary  condition  and 
outputs  logic  flags  to  control  the  subsequent  sensitivity  computations.  Then 
boundary  condition  dependent  constraints  which  are  explicit  functions  of  the 
design  variables  (frequency  and  flutter)  are  computed.  Next,  the  sensitivi¬ 
ties  of  the  constraints  to  the  displacements  for  those  constraints  which  are 
explicit  functions  of  the  displacements  (stress  and  displacement  constraints, 
for  example)  are  computed  using  the  MAKDFU  module.  For  these  types  of  con¬ 
straints,  the  product  of  the  stiffness  sensitivities  and  the  displacements  and 
the  product  of  the  mass  sensitivities  and  the  displacements  and  accelerations 
are  also  computed  and  modified  appropriately  to  account  for  design  dependent 
loads  and  inertia  relief.  The  resulting  matrix  is  then  reduced  and  used  to 
solve  for  the  sensitivities  of  the  displacements  to  the  design  variables. 
This  matrix  is  recovered  to  the  free  displacement  set  in  a  manner  similar  to 
the  recovery  of  the  outputs  in  the  analysis  phase  of  the  optimization  segment. 
The  final  module  within  the  boundary  condition  loop  for  sensitivity  evaluation 
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is  MKAMAT.  Within  this  module  the  constraint  sensitivities  to  the  design 
variables  are  formed  from  the  product  of  the  constraint  and  displacement 
sensitivity  matrices  previously  obtained. 

After  all  the  active  optimization  boundary  conditions  have  been 
processed,  the  DESIGN  module  is  called.  The  approximate  design  problem  is 
arranged  for  use  by  the  optimizer  and  is  solved  using  the  strategy  selected 
in  the  solution  control.  Following  convergence  of  the  approximate  problem, 
execution  returns  to  the  top  of  the  optimization  loop  and  a  complete  reanaly¬ 
sis  for  all  the  boundary  conditions  is  performed.  Once  completed,  the  ACTCON 
module  determines  if  the  global  problem  is  converged  and,  if  so,  sets  the 
global  convergence  flag  to  2  causing  the  execution  to  pass  to  the  top  of  the 
analysis  segment. 

If  any  analysis  boundary  conditions  exist,  they  will  be  processed  in  a 
manner  similar  to  the  analysis  phase  of  the  optimization  segment.  After 
performing  the  requested  final  analyses  (if  any)  the  executive  system 
terminates  the  ASTROS  execution. 

4.4.3  Modifying  the  Standard  MAPOL  Sequence 

The  standard  MAPOL  sequence  is  provided  to  allow  a  user  to  run  the 
ASTROS  system  without  detailed  knowledge  of  the  MAPOL  language  or  the  standard 
sequence.  There  is  not,  however,  any  requirement  that  the  standard  sequence 
be  used.  The  MAPOL  Programmer's  Manual  (Appendix  B)  outlines  the  procedure 
for  writing  a  valid  MAPOL  sequence,  and  any  series  of  syntactically  correct 
MAPOL  statements  may  be  used  to  direct  the  ASTROS  procedure.  All  the  engi¬ 
neering,  utility  and  matrix  manipulation  modules  shown  in  Section  4.4.2. 1  are 
available  to  any  MAPOL  sequence  used  to  direct  the  system.  In  addition,  there 
are  a  number  of  intrinsic  functions  such  as  SIN  and  ABS  that  are  also  availa¬ 
ble.  Their  use  is  detailed  in  the  MAPOL  Programmer's  Manual.  The  sophisti¬ 
cated  MAPOL  user  is  thus  provided  with  a  very  flexible  control  language  to 
manipulate  the  ASTROS  system.  This  subsection  describes  simple  modifications 
to  the  standard  algorithm  to  print  out  additional  data  items,  to  fine  tune  the 
optimization  algorithm  and  to  restore  an  ASTROS  analysis  that  was  partially 
executed  on  a  previous  run.  No  set  of  examples,  however,  can  possible  indi¬ 
cate  the  full  range  of  available  capabilities;  the  user  is  therefore  cautioned 
not  to  be  overly  constrained  by  this  discussion. 
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In  order  to  avoid  vast  quantities  of  output  and  to  limit  the  execution 
time,  the  standard  output  is  kept  to  a  minimum.  Several  utilities,  listed  in 
Section  4. 4. 2.1,  can,  however,  be  inserted  in  the  standard  sequence  to  output 
data  stored  on  the  data  base.  In  addition,  a  utility  has  been  written  to 
print  out  the  structural  set  definition  table  to  aid  in  the  debugging  of  the 
structural  model.  The  UTMPRT,  UTGPRT,  UTRPRT  and  UTUPRT  print  utilities  dump 
the  contents  of  specified  data  base  entities  to  the  user's  output  file.  These 
can  be  used  anywhere  in  the  MAPOL  sequence  after  the  specified  entity  has  been 
filled  with  data.  The  USETPRT  utility  provides  the  user  with  the  ability  to 
print  the  structural  set  definition  table  (USET)  in  a  format  which  aids  in 
debugging  the  structural  model  --a  useful  utility  if  the  structural  model  is 
reasonably  complex.  These  utilities  provide  the  user  with  some  simple  tools 
to  allow  closer  interaction  with  the  data  stored  on  the  data  base  and  to 
provide  capability  to  more  closely  track  the  execution. 

The  print  utilities  provide  data  visability  without  modifying  the 
basic  execution  of  the  standard  sequence.  At  a  slightly  more  complex  level, 
the  user  might  desire  to  fine  tune  the  optimization  procedure  or  to  track  the 
iterations  of  the  optimizer  more  closely.  Tables  4  and  5  in  Subsection  4.4.1 
include  a  number  of  parameters  which  are  used  by  ASTROS  to  direct  the 
optimization.  Any  of  these  parameters  can  be  changed  by  the  user  at  any  point 
in  the  MAPOL  sequence.  For  example,  the  MOVLIM  parameter  (which  is 
initialized  in  the  MAPOL  sequence)  could  be  changed  to  a  different  value  after 
the  fifth  iteration  by  placing  the  following  statement  immediately  after  the 
WHILE  test  on  CONVERGE: 

IF  NITER  >  5  MOVLIM  -  1.5; 

Obviously,  the  conditional  testing  could  become  as  complex  as  the  MAPOL 
programmer  desires. 

A  more  basic  scalar  parameter  that  the  user  might  wish  to  modify  is 
the  MAXITER  parameter  which  specifies  the  maximum  number  of  times  the 
optimization  segment  will  be  executed  if  the  optimization  problem  does  not 
reach  convergence.  The  standard  sequence  uses  a  value  of  15  for  this  parame¬ 
ter  which  has  proved  to  be  a  good  choice  for  many  problems.  A  typical  design 
model  often  takes  several  runs  to  debug,  however,  so  the  user  might  wish  to 
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reduce  MAXITER  to  a  minimal  number  (like  one)  until  the  model  has  been  veri¬ 
fied.  As  will  be  discussed  later,  the  ASTROS  system  does  provide  a  limited 
restart  capability  so  that  the  optimization  can  be  continued  from  this  point. 

The  parameters  EPS,  NRFAC,  CTL,  CTLMIN,  and  CNVRGLIM  can  be  used  to 
fine  tune  the  constraint  screening  and  global  convergence  criteria.  The 
standard  values  provide  a  conservative  constraint  screening  (that  is,  a  large 
number  of  constraints  are  retained)  and  the  convergence  criteria  is  somewhat 
lenient  in  its  definition  of  a  violated  constraint.  These  parameters  can  be 
modified  to  be  more  finely  tuned  to  the  particular  design  problem  using  the 
detailed  definitions  of  these  parameters  given  in  the  ACTCON  module  documenta¬ 
tion  and  in  the  Theoretical  Manual. 

The  brief  discussion  above  does  not  begin  to  describe  all  the  options 
open  to  the  sophisticated  ASTROS  user.  It  does,  however,  outline  some  of  the 
most  commonly  performed  modifications  to  the  standard  MAPOL  algorithm.  The 
concepts  described  can  be  extended  to  a  large  number  of  similar  changes;  e.g., 
modifying  the  input  dynamic  pressure  value  within  the  MAPOL  sequence  could  be 
done  to  avoid  rerunning  the  base  run  of  an  ASTROS  execution.  At  a  more 
advanced  level,  the  MAPOL  relational  data  base  entity  utilities  can  be  used  to 
directly  modify  the  design  variable  values  or  objective  sensitivities. 

As  previously  mentioned,  the  ASTROS  system  has  a  limited  restart 
capability.  It  is  not  sophisticated,  and  therefore  requires  that  the  user  be 
somewhat  familiar  with  the  details  of  the  engineering  modules.  There  are, 
however,  some  simple  (and  useful)  forms  of  restart  that  can  be  used  without 
learning  these  details.  To  set  up  for  a  restart,  it  is  necessary  that  a  run 
be  made  and  the  run-time  data  base  saved.  On  the  subsequent  run(s),  this  data 
base  will  be  used  and  declared  to  be  "OLD"  on  the  ASSIGN  DATABASE  entry  in  the 
ASTROS  input  stream.  The  following  restrictions  are  strongly  recommended: 

(1)  No  preface  module  (with  the  exception  discussed  below)  should  be 
executed  in  both  the  initial  run  and  the  restart  run. 

(2)  Terminate  the  initial  run  at  the  top  or  bottom  of  a  loop,  not  in 
the  middle . 

The  exception  is  that  the  Input  File  Processor  module  must  always  be  called. 
Its  execution  is  required  in  order  to  load  the  data  base  bit  maps  (see 
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CASDBMAP  entity  documentation  in  the  Programmer's  Manual)  into  memory.  Note 
that,  in  a  restart  run,  the  IFP  will  append  any  BULK  DATA  in  the  input  stream 
onto  the  previously  existing  data. 

A  further  point  must  be  made  regarding  the  use  of  the  ASTROS  system  in 
a  restart  mode:  the  scalar  parameters  that  are  used  in  the  MAPOL  sequence  do 
not  have  their  values  stored  on  the  data  base.  Therefore,  if  the  module  that 
defines  a  particular  parameter  is  not  being  called  in  the  restart  MAPOL 
sequence,  the  value  of  the  parameter  must  be  explicitly  set  in  the  restart 
MAPOL  sequence.  As  an  example,  suppose  that  all  the  preface  modules  were 
executed  in  the  first  run  and  the  restart  run  picked  up  at  the  top  of  the 
optimization  segment.  The  parameter  NDV  and  all  the  parameters  output  from 
the  SOLUTION  module  would  need  to  be  reset  "by  hand"  in  the  restart  sequence 
to  have  the  values  they  had  in  the  first  run.  Although  this  restart  capabili¬ 
ty  is  limited  and  somewhat  awkward  to  use,  it  is  useful  in  the  optimization 
task  since  it  allows  the  user  to  terminate  the  execution  at  the  end  of  the 
preface  or  the  end  of  some  number  of  iterations  and  restart  from  the  current 
design.  It  can  also  be  useful  to  reuse  a  data  base  to  perform  specialized 
operations  developed  by  the  user  on  the  data  collections  resident  on  the  data 
base  files. 
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SECTION  V 


THE  SOLUTION  CONTROL  PACKET 

The  solution  control  packet  provides  the  means  by  which  the  user 
selects  the  optimization  and  analysis  tasks  to  be  performed  by  the  ASTROS 
system,  their  order  of  execution  and  the  engineering  data  related  to  each. 
The  solution  control  commands  are  analogous  in  purpose  to  the  NASTRAN  Case 
Control  commands  but  they  are  very  different  in  form  and  subtly  different  in 
interpretation.  Understanding  the  differences  between  ASTROS  and  NASTRAN  in 
the  area  of  solution  control  is  fundamental  in  understanding  multidisciplinary 
optimization  in  the  ASTROS  system  because  the  solution  control  command  struc¬ 
ture  follows  directly  from  the  ASTROS  requirement  to  perform  multidisciplinary 
analyses  in  a  single  run.  It  is  considered  critical  that  the  user  clearly 
understand  the  subtleties  of  solution  control  syntax  and  hierarchies.  This 
section,  therefore,  augments  the  presentation  of  the  solution  control  mechan¬ 
ics  with  a  discussion  of  the  design  considerations  that  are  embodied  in  the 
solution  control  commands.  The  detailed  definition  of  all  solution  control 
commands  is  contained  in  Appendix  D. 

In  ASTROS,  the  solution  control  is  very  closely  linked  to  the  struc¬ 
ture  of  the  stahdard  MAPOL  sequence.  It  may  be  advantageous  for  the  beginning 
user  to  read  the  standard  MAPOL  sequence  discussion  in  the  preceding  section 
and  to  study  the  Theoretical  Manual  discussion  of  multidisciplinary 
optimization  before  reading  the  remainder  of  this  section. 

The  solution  control  packet  is  initiated  with  the  keyword  SOLUTION 
which  follows  the  DEBUG  and  MAPOL  packets  (if  present)  in  the  input  data 
stream.  The  packet  is  terminated  when  the  BULK  DATA  packet,  or  the  end  of  the 
input  stream  is  encountered.  The  data  are  composed  of  solution  control 
statements  which  can  begin  in  any  column  and  can  extend  over  multiple  physical 
records.  Each  statement  is  formed  from  a  combination  of  keywords  separated  by 
blanks  or  commas  as  indicated  in  the  detailed  syntactical  descriptions  con¬ 
tained  in  Appendix  D.  Further,  each  command  keyword  can  be  abbreviated  by  the 
first  four  (or  more)  characters  of  the  keyword.  The  solution  control  packet 
follows  a  prescribed  hierarchy  with  the  following  levels: 
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TYPE  OF  BOUNDARY  CONDITION 


BOUNDARY  CONDITION(S) 

DISCIPLINE(S) 

DISCIPLINE  OPTION(S) 

Each  of  these  levels  is  discussed  in  the  following  subsections  and  compared 
and  contrasted  to  their  NASTRAN  counterparts.  In  addition  to  these  hierarchi¬ 
cal  commands,  there  are  commands  for  output  processing  that  can  occur  at 
several  levels  in  the  hierarchy.  This  section  presents  the  available  commands 
and  output  quantities,  but  the  reader  is  referred  to  Section  VII  of  this 
document  for  the  in-depth  presentation  of  ASTROS  output  processing.  The 
hierarchical  nature  of  the  solution  control  means  that  each  level  generates  a 
set  of  "defaults"  to  be  carried  over  to  the  next  lower  level.  These  defaults 
are  in  force  until  they  are  overridden.  The  user  must  be  aware  of  this 
feature,  especially  when  requesting  output  at  higher  levels.  It  is  possible 
to  get  print  requests  "by  default"  where  they  are  not  expected  if  one  is  not 
careful  with  the  solution  control  hierarchy. 

5.1  TYPE  OF  BOUNDARY  CONDITION 

ASTROS  has  been  designed  primarily  to  be  an  automated  design  tool,  but 
it  can  also  perform  analyses  without  doing  any  design.  This  is  reflected  in 
the  division  of  the  solution  control  packet  into  two  subpackets,  either  of 
which  is  optional.  The  first,  "OPTIMIZE,"  subpacket  defines  the  boundary 
condition(s)  and  discipline (s)  which  will  generate  design  constraints  to  be 
used  in  the  redesign  task.  In  defining  an  optimization  boundary  condition, 
the  user  either  implicitly  or  explicitly  specifies  that  constraints  be  applied 
to  certain  (discipline  dependent)  response  quantities.  ASTROS  then  considers 
the  complete  set  of  constraints  from  all  disciplines  in  all  optimization 
boundary  conditions  in  the  redesign  task.  The  second,  "ANALYZE,"  subpacket 
defines  analyses  that  are  to  be  performed  on  the  possibly  redesigned  struc¬ 
ture.  The  ANALYZE  subpacket  is  intended  to  provide  the  designer  with  the 
means  to  obtain  additional  output  that  is  not  desired  during  the  optimization 
phase  or  to  perform  additional  analyses  which  were  not  performed  in  the  design 
task.  It  can  also  be  used  to  perform  analyses  on  structures  that  are  not  to 
be  designed  at  all.  The  form  of  the  solution  control  packet  is  then: 
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SOLUTION 


OPTIMIZE  STRATEGY  -  <n> 

Optimization  Subpacket 

END 

ANALYZE 

.  Analysis  Subpacket 

END 

If  optimization  is  being  performed,  the  OPTIMIZE  subpacket  must 
precede  the  ANALYZE  subpacket.  Any  number  of  boundary  conditions  and/or 
disciplines  can  be  performed  in  either  subpacket. 

5.2  BOUNDARY  CONDITION 

Each  analysis  discipline  requires  a  set  of  physical  boundary  condi¬ 
tions  and,  in  the  case  of  unrestrained  structures,  a  set  of  fictitious  sup¬ 
ports.  These  are  defined  in  ASTROS  in  a  manner  very  similar  to  that  in 

NASTRAN;  namely,  through  the  definition  of  multipoint  constraints  (MPC) , 
single  point  constraints  (SPC)  and  support  points  (SUPORT) .  Unlike  NASTRAN, 
however,  ASTROS  requires  a  more  rigorous  definition  of  a  boundary  condition. 
The  reason  for  this  is  that  the  user  must  ensure  that  the  system  matrices  at 
each  stage  of  matrix  reduction  are  uniquely  defined  by  the  boundary  condition 
specification.  For  example,  if  the  user  intends  to  perform  a  normal  modes 
analysis,  a  modal  transient  analysis  and  a  modal  flutter  analysis  in  the  same 
boundary  condition,  ASTROS  requires  that  the  modal  representation  of  the 
system  under  analysis  be  the  same  for  each  discipline  in  the  boundary  condi¬ 
tion.  This  requirement,  which  is  necessary  to  efficiently  perform 

multidisciplinary  analysis,  adds  a  number  of  additional  parameters  to  the 
boundary  condition  definition  beyond  the  MPC,  SPC  and  SUPORT  definitions. 
They  include  definitions  to  perform  matrix  reductions  (available  in  NASTRAN 
through  BULK  DATA  but  not  always  selectable  in  the  Case  Control  Deck)  as  well 
as  selection  of  extra  point  degrees  of  freedom,  transfer  functions  and  other 
discipline  dependent  matrix  assembly  information.  In  NASTRAN,  these  data  are 
either  implicitly  selected  through  the  rigid  format  selection  and/or  bulk  data 
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or  are  a  "discipline  option"  in  the  case  control  deck.  While  the  boundary 
condition  definition  in  ASTROS  appears  to  be  very  complex,  it  is  relatively 
simple  if  one  realizes  that  the  fundamental  purpose  of  the  BOUNDARY  command  is 
to  uniquely  specify  the  system  level  matrices  and  the  matrix  reductions  that 
should  be  performed  on  them. 

There  is  one  level  of  "boundary  condition"  specification  which  is  not 
treated  in  the  BOUNDARY  command.  It  deals  with  symmetry  options  which  play  a 
restrictive  role  in  multi-disciplinary  analysis,  especially  for  aerodynamic 
disciplines.  The  symmetry  options  are  often  limited  by  the  nature  of  the 
structural  and/or  aerodynamic  models  that  are  defined  in  the  bulk  data  packet. 
For  example,  if  the  structural  model  is  a  half  model  only,  the  user  cannot 
specify  that  asymmetric  structural  boundary  conditions  be  analyzed.  This 
option  is  needed  for  the  user  to  perform  an  asymmetric  aeroelastic  analysis 
with  a  structural  half  model.  Unfortunately,  this  is  not  possible  in  ASTROS. 
Whenever  possible,  the  implicit  (model-defined)  boundary  condition 
specifications  that  existed  in  the  NASTRAN  bulk  data  definitions  and  in  the 
interface  between  bulk  data  and  solution  control  have  been  replaced  with 
solution  control  dependent  options.  There  are,  however,  still  limitations 
imposed  through  the  interactions  between  the  model  and  the  solution  control  on 
combining  symmetric/antisymmetric  and  asymmetric  boundary  conditions  within  a 
single  run. 

There  are  13  boundary  condition  specifications  in  ASTROS: 

Selects  single  point  constraints  defining  Degrees 
of  Freedom  (DOF's)  with  fixed  or  prescribed 
motion. 

Selects  multi -point  constraints  defining  dependen¬ 
cy  relations  among  specific  DOF's. 

Defines  the  DOF's  to  be  retained  after  a  Guyan 
reduction. 

Defines  DOF's  to  provide  support  conditions  for 
free-free  modal  extraction,  inertial  relief  and 
aeroelastic  analyses. 

Specifies  an  EIGR  bulk  data  entry  which  gives 
eigenvalue  extraction  data  if  an  eigenanalysis  is 
to  be  performed. 

Specifies  an  input  stiffness  matrix. 

Specifies  an  input  mass  matrix. 
bh 


SPC 

MPC 

REDUCE 

SUPPORT 

METHOD 

K2PP 


M2PP 


B2PP 


Specifies  an  input  damping  matrix. 

DYNRED  -  Invokes  dynamic  reduction. 

INERTIA  -  Specifies  a  JSET  bulk  data  set  for  dynamic  reduc¬ 

tion  . 

ESET  -  Specifies  the  extra  point  DOF's  to  be  included  in 

dynamic  response  analyses. 

TFL  -  Specifies  transfer  functions  that  are  to  be 

included  in  dynamic  response  analyses. 

DAMPING  -  Specifies  structural  or  viscous  damping  to  be  used 

in  dynamic  response  analyses. 

A  boundary  condition  is  defined  by  the  BOUNDARY  request  and  one  or 
more  of  these  further  specifications,  each  of  which  points  to  bulk  data 
entries . 

As  indicated  above,  the  specification  of  METHOD,  K2PP,  M2PP,  B2PP, 
ESET,  DAMPING  and  TFL  at  this  level  in  the  hierarchy  is  in  recognition  of  the 
fact  that  a  number  of  the  disciplines  could  require  different  sets  of  data  for 
the  associated  items  and  it  is  desirable  to  group  together  operations  with  one 
set  of  items.  This  does,  by  definition,  create  a  restriction  that  only  one 
e igenana lysis  and  only  one  set  of  p-size  matrices  and  input  transfer  functions 
can  be  accommodated  per  boundary  condition.  Examples  of  boundary  definitions 
are: 

BOUNDARY  SPC  -  100 

BOUNDARY  MPC  =  10,  SPG  -  100 

BOUNDARY  SPC  -  10,  MPC  -  20,  REDUCE  -  30,  SUPPORT  -  40 

BOUNDARY  SPC  -  10,  REDUCE  -  20,  METHOD  -  100 

BOUNDARY  SPC  ~  1,  K2PP  -  STIFF,  M2PP  -  MASS,  B2PP  -  DAMP 

BOUNDARY  SPC  -  4,  DYNRED  -  2,  INERTIA  -  4 

Note  that  all  desired  specifications  are  listed  and  that  their  order 
of  appearance  is  not  important. 
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Several  boundary  conditions  may  appear  within  a  given  subpacket.  For 

example: 

ANALYZE 

BOUNDARY  SPC  -  10 
STATICS 

BOUNDARY  SPC  -  20,  REDUCE  -  3-,  METHOD  -  1111 
STATICS 

MODES 

END 

In  this  case,  a  statics  analysis  is  performed  using  the  first  boundary 
condition  followed  by  a  statics  and  modes  analysis  for  the  second  boundary 
condition.  Note  that  unlike  NASTRAN,  the  sets  of  points  to  be  retained  in  the 
Guyan  reduction  and  used  for  the  support  definition  are  selected. 

The  appearance  of  a  BOUNDARY  command  leads  to  expensive  matrix  parti¬ 
tioning  and  decomposition  operations.  Therefore,  some  thought  should  be 
expended  to  avoid  unnecessary  computer  resource  use.  For  example,  suppose  an 
ASTROS  execution  was  directed  to  perform  static  analyses  with  two  boundaries: 
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SPC  -  10  and  SPC  -  20,  and  a  dynamic  analysis  with  two  boundaries:  SPC  -  10 
and  SPC  -  100.  The  direct  solution  sequence  could  be: 

ANALYZE 

BOUNDARY  SPC  -  10 
STATICS 

BOUNDARY  SPC  -  20 
STATICS 


BOUNDARY  SPC  -  10,  METHOD  -  30 
MODES 


BOUNDARY  SPC  -  100,  METHOD  -  40 
MODES 


END 


This  sequence  would  cause  four  separate  partitionings  of  the  system 
level  matrices.  On  the  other  hand,  the  sequence: 


ANALYZE 


BOUNDARY  SPC  -  10,  METHOD  -  30 
STATICS 


MODES 

BOUNDARY  SPC  -  20 
STATICS 


BOUNDARY  SPC  -  100,  METHOD  -  40 
MODES 


END 

eliminates  one  of  the  four  partitioning  operations. 

5.3  DISCIPLINES 

A  number  of  types  of  analyses,  or  disciplines,  can  be  performed  during 
a  given  ANALYZE  or  OPTIMIZE  boundary  condition.  In  fact,  it  is  this 
multidisciplinary  capability  that  makes  the  ASTROS  code  viable  in  a  prelimi¬ 
nary  design  context.  The  preceding  sections  have  already  alluded  to  the  fact 
that  each  of  these  disciplines  has  an  associated  set  of  commands: 


ANALYZE 


BOUNDARY  SPC  -  30 
DISCIPLINE  1 


DISCIPLINE  2 


END 

A  suite  of  seven  disciplines  are  available  in  ASTROS.  These  are: 


STATICS 

- 

Static  structural  analysis 

MODES 

- 

Normal  modes  of  vibration 

SAERO 

- 

Steady-state  aeroelastic  analysis 

FLUTTER 

- 

Aeroelastic  stability  analysis 

TRANSIENT 

- 

Transient  response  analysis 

FREQUENCY 

- 

Frequency  response  analysis 

BLAST 

- 

Transient  response  to  a  nuclear  blast 

Of  these  options,  TRANSIENT,  FREQUENCY,  and  BLAST  do  not  generate  any 
design  constraints  and  so  are  not  useful  in  OPTIMIZE  boundary  conditions. 
Should  the  user  wish  to  see  output  from  these  disciplines  during  the 
optimization,  however,  they  are  supported  in  the  OPTIMIZE  subpacket. 

The  standard  MAPOL  sequence  contains  the  restriction  that  the  SAERO 
discipline  cannot  share  its  boundary  condition  with  another  discipline  and  two 
or  more  SAERO  disciplines  in  the  same  boundary  condition  must  use  the  same 
symmetry,  Mach  number  and  dynamic  pressure.  These  restrictions  follow  from 
the  requirement  that  system  level  matrices  be  uniq  le  within  a  boundary 
condition.  The  asymmetric  aeroelastic  correction  matrix  that  is  applied  to 
the  stiffness  matrix  precludes  the  combination  of  SAERO  and  non- SAERO 
disciplines  in  the  same  boundary  condition.  Further,  the  aeroelastic 
corr  ction  is  a  function  of  symmetry,  Mach  number  and  dynamic  pressure, 
accounting  for  the  latter  restriction. 
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5.4 


DISCIPLINE  OPTIONS 


Each  of  the  disciplines  requires  further  options  to  completely  define 
the  execution  process.  These  options  point  to  set  IDs  in  the  bulk  data  packet 
that  define  engineering  data.  For  example,  the  STATICS  discipline  requires 
that  loads  information  be  supplied.  This  is  implemented  in  ASTROS  by  a 
parenthetical  "phrase"  attached  to  the  STATICS  discipline: 

SOLUTION 

OPTIMIZE  STRATEGY  -  57 


STATICS  (MECH  -  10) 


END 

In  this  case,  bulk  data  applied  load  entries  with  a  -set  ID  of  10  are 
used  to  construct  a  mechanical  load  vector  in  a  statics  analysis.  In  general, 
the  discipline  commands  have  the  form: 


<disc>  <type>  { (<option>  -  <n>,  <option>  -  <n>) ) 


The  discipline  options  that  are  available  are: 


MECHANICAL 

GRAVITY 

THERMAL 

TRIM 


DCONSTRAINT 


DLOAD 


TSTEP 


Specify  load  set  IDs  for  the  STATIC  discipline. 


Specifies  a  TRIM  bulk  data  entry  which  gives 

flight  condition  information  for  the  SAERO 
discipline . 

Specifies  the  set  IDs  of  constraint  bulk  data 

entries  that  apply  for  the  given  discipline. 

Specifies  applied  loads  for  the  TRANSIENT  and 

FREQUENCY  disciplines. 

Specifies  the  time  step  for  the  TRANSIENT  and 

BLAST  disciplines  as  well  as  for  the  discrete  form 
of  the  GUST  discipline  option. 
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FSTEP  -  Specifies  the  frequencies  for  the  FREQUENCY  and 

the  harmonic  form  of  the  GUST  discipline  option. 

IC  -  Specifies  the  initial  conditions  that  are  to  be 

used  in  the  direct  method  for  the  TRANSIENT 
discipline . 

FFT  -  Specifies  that  the  Fast  Fourier  technique  is  to  be 

used  in  the  TRANSIENT  or  GUST  disciplines. 

BLCOND  -  Specifies  parameters  for  the  BLAST  discipline. 

FLCOND  -  Specifies  parameters  for  the  FLUTTER  discipline. 

GUST  -  Specifies  that  a  gust  analysis  is  to  be  performed 

for  the  accompanying  transient  or  frequency 
discipline . 

The  discipline  types  are: 

DIRECT  -  Specifies  that  the  direct  method  is  to  be  used  in 

the  TRANSIENT  or  FREQUENCY  disciplines. 

MODAL  -  Specifies  that  the  modal  method  is  to  be  used  in 

the  TRANSIENT  or  FREQUENCY  disciplines. 

Table  6  presents  a  matrix  that  defines  options  and  types  available  for 
each  of  the  disciplines.  In  addition,  disciplines  requiring  particular 
boundary  condition  specifications  are  noted;  for  example,  modal  disciplines 
require  a  METHOD  specification  on  the  BOUNDARY  command.  The  following  subsec¬ 
tions  present  each  discipline  in  turn  to  more  explicitly  define  the  discipline 
options.  Most  importantly,  these  subsections  present  the  definition  of  a 
"subcase"  of  the  discipline  as  it  is  defined  in  the  ASTROS  system  and  present 
the  response  quantities  that  can  be  constrained  in  the  optimization  task. 

5.4.1  "STATICS"  Discipline  Options 

One  or  more  of  the  MECHANICAL,  CFAVITY  or  THERMAL  load  specifications 
must  be  called  out  as  a  discipline  option  for  STATICS.  Each  STATICS  disci¬ 
pline  constitutes  one  subcase  (one  load  vector)  so  specifying  a  combination  of 
load  types  will  generate  a  linear  combination  of  the  selected  loads.  A 
reference  to  the  LOAD  bulk  data  entry  as  a  MECHANICAL  load  can  also  be  used  to 
obtain  linear  load  combinations.  If  the  STATICS  discipline  appears  in  the 
OPTIMIZE  subpacket,  the  DCONSTRAINT  option  can  be  used  to  refer  to  DCONDSP 
bulk  data  entries  to  apply  displacement  constraints.  Stress  constraints 
defined  on  DCONSTR  bulk  data  entries  are  applied  to  all  STATICS  (and  some 


61 


TABLE  6.  DISCIPLINE  OPTIONS  MATRIX 


OPTION 

DISCIPLINE 

STAT 

SAER 

FLUT 

■m 

FREO 

BLAS 

MECH 

0 

— 

— 

— 

— 

— 

GRAV 

0 

— 

— 

— 

— 

— 

— 

THERM 

0 

— 

— 

— 

— 

— 

— 

TRIM 

— 

— 

R 

— 

— 

— 

— 

DCONSTRAINT 

0 

0 

0 

0 

— 

— 

— 

DLOAD 

— 

— 

— 

— 

R 

R 

— 

TSTEP 

— 

— 

... 

— 

R 

— 

R 

FSTEP 

IC 

FFT 

— 

— 

— 

— 

R 

— 

— 

— 

— 

— 

u 

0 

0 

— 

DIRECT 

— 

— 

— 

— 

0 

0 

— 

MODAL 

— 

— 

— 

— 

0 

0 

— 

BLCOND 

— 

— 

— 

— 

— 

•  ... 

R 

FLCOND 

— 

— 

— 

R 

— 

— 

— 

GUST 

— 

— 

— 

— 

0 

0 

— 

NOTES:  1.  R  -  Required,  0  -  Optional,  -  -  Not  applicable. 


2.  Either  DIRECT  or  MODAL  must  be  specified  for  the  TRANSIENT  and 
FREQUENCY  disciplines. 

3.  The  BOUNDARY  solution  command  must  include  a  method  specifica¬ 
tion  if  the  MODES,  FLUTTER  or  BLAST  discipline  is  specified  or 
if  the  MODAL  option  of  TRANSIENT  or  FREQUENCY  discipline  is 
specified. 

4.  At  least  one  of  MECH,  GRAV  or  THERM  must  be  specified  for 
statics . 


I 


4 


1 


4 


ft 


ft 
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SAERO)  subcases  In  the  OPTIMIZE  subpacket  if  any  DCONSTR  are  in  the  BULK  DATA 
packet.  Therefore  DCONSTR  entries  are  not  explicitly  referenced  in  the 
solution  control. 

5.4.2  "MODES”  Discipline  Options 

MODES  is  completely  defined  for  analysis  by  the  METHOD  boundary 
specification,  which  refers  to  an  EIGR  bulk  data  entry  selecting  the 
eigenvalue  extraction  method.  If,  however,  the  modal  analysis  is  performed  in 
the  OPTIMIZE  subpacket,  the  DCONSTRAINT  option  can  be  used  to  apply  frequency 
constraints  through  the  DCONFRQ  bulk  data  entry.  Note  that  more  than  one 
frequency  can  be  constrained  and  than  more  than  one  constraint  can  be  placed 
on  the  same  modal  frequency.  The  user  is  warned  against  defining  the  frequen¬ 
cy  constraints  in  such  a  way  as  to  specify  an  excluded  range  of  frequencies 
for  a  mode ;  for  example ,  requiring  that  a  modal  frequency  be  below  10  Hz  OR 
above  20  Hz.  ASTROS  treats  all  applied  constraints  as  Boolean  AND  statements 
so  the  above  example  would  be  interpreted  by  ASTROS  as  an  inconsistent  re¬ 
quirement  that  the  frequency  be  both  above  20  Hz  AND  below  10  Hz . 

In  ASTROS,  each  eigenvector  is  considered  to  be  a  separate  subcase. 
It  is  important  to  note  in  this  case  that  more  than  one  subcase  is  represented 
by  a  single  solution  control  discipline  statement.  In  output  requests, 
therefore,  the  subcases  for  which  output  is  desired  must  be  explicitly  select¬ 
ed.  This  is  presented  in  greater  detail  in  Subsection  5.5  and  in  Section  VII. 

5.4.3  ''SAERO"  Discipline  Options 

The  SAERO  discipline  must  have  a  TRIM  condition  specified  in  the 
solution  control.  For  analysis,  this  selection  completes  the  specification  of 
the  discipline  with  each  TRIM  condition  generating  up  to  one  subcase.  If  the 
trim  type  on  the  TRIM  bulk  data  is  zero,  no  displacement  fields  and,  there¬ 
fore,  no  subcases,  are  generated.  In  the  OPTIMIZE  subpacket,  the  DCONSTRAINT 
option  can  be  used  to  select  a  number  of  different  constraint  types  which 
depend  on  the  type  of  TRIM  analysis  selected.  In  general  the  DCONSTRAINT  can 
refer  to  DCONDSP  bulk  data  entries  for  displacement  constraints,  DCONCLA  for 
lift  effectiveness  constraints  and  DCONALE  for  aileron  effectiveness  con¬ 
straints  (DCONSTR  constraints  are  implicitly  selected  as  noted  in  the  STATICS 
subsection).  The  strength  constraints  are  only  applicable  when  the  trim  type 
selected  on  the  TRIM  bulk  data  entry  is  1  or  2.  The  aileron  effectiveness 
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constraints  are  only  applicable  for  antisymmetric  analyses  of  trim  type  0  and 
the  lift  effectiveness  constraints  require  a  symmetric  trim  analysis  of  type 
1  or  2.  The  reader  is  referred  to  Section  VI  and  Appendix  E  for  additional 
information  on  the  TRIM  bulk  data  entry. 

5.4.4  "FLUTTER"  Discipline  Options 

The  FLUTTER  discipline  must  have  one  or  more  flight  conditions 
specified  in  the  solution  control  through  the  FLCOND  option.  For  analysis, 
this  selection  completes  the  specification  of  the  discipline  with  each  FLCOND 
condition  generating  up  to  one  "subcase"  (consisting  of  the  flutter 
eigenvector)  for  each  Mach  number  and  density  ratio  on  the  FLUTTER  bulk  data 
entry  if  flutter  occurs.  In  the  OPTIMIZE  subpacket,  the  "subcase"  has  no 
meaning  for  flutter,  although  more  than  one  flutter  analysis  can  be  performed. 
The  DCONSTRAINT  option  can  be  used  to  select  DCONFLT  bulk  data  entries  to 
place  a  required  damping  limit  on  each  of  the  roots  extracted  in  the  flutter 
analysis.  The  actual  flutter  root  and  eigenvector  cannot  be  obtained  in  the 
OPTIMIZE  subpacket. 

5.4.5  "TRANSIENT"  Discipline  Options 

The  TRANSIENT  discipline  must  have  time  step  and  load  information 
specified  in  the  solution  control  through  the  TSTEP  and  DLQAD  options.  This 
discipline  has  no  associated  constraints  and,  while  it  is  fully  supported  in 
the  OPTIMIZE  subpacket,  it  will  not  generate  data  for  use  in  the  redesign 
task.  There  are  many  additional  options  which  can  be  selected  in  transient 
analysis.  These  are  (1)  initial  conditions,  which  can  be  selected  through  the 
IC  option  for  DIRECT  transient  analyses;  (2)  Fast  Fourier  Transform  tech¬ 
niques,  which  are  selected  with  the  FFT  option;  and  (3)  discrete  gust  loads, 
which  are  applied  using  the  GUST  option.  In  each  case,  the  solution  control 
option  points  to  a  bulk  data  entry  having  the  same  name. 

In  ASTROS,  each  time  step  for  which  output  is  saved  is  considered  to 
be  a  separate  subcase.  It  is  important  to  note  that,  like  the  MODES  disci¬ 
pline,  more  than  one  subcase  is  represented  by  a  single  solution  control 
discipline  statement.  In  output  requests,  therefore,  the  subcases  for  which 
output  is  desired  must  be  explicitly  selected.  This  is  presented  in  greater 
detail  in  Subsection  5.5  and  in  Section  VII. 
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5.4.6  "FREQUENCY"  Discipline  Potions 


The  FREQUENCY  discipline  is  very  similar  to  the  TRANSIENT  discipline 
presented  in  the  preceding  subsection.  Frequency  step  and  load  information 
are  specified  in  the  solution  control  through  the  FSTEP  and  DLOAD  options. 
This  discipline  has  no  associated  constraints  and,  while  it  is  fully  supported 
in  the  OPTIMIZE  subpacket,  it  will  not  generate  data  for  use  in  the  redesign 
task.  There  are  two  additional  options  which  can  be  selected  in  frequency 
response  analysis.  These  are  (1)  Fast  Fourier  Transform  techniques,  which  are 
selected  with  the  FFT  option;  and  (2)  harmonic  gust  loads,  which  are  applied 
using  the  GUST  option.  In  each  case,  the  solution  control  option  points  to  a 
bulk  data  entry  having  the  same  name . 

In  ASTROS,  each  frequency  step  for  which  output  is  saved  is 
considered  to  be  a  separate  subcase.  It  is  important  to  note  that,  like  the 
MODES  discipline,  more  than  one  subcase  is  represented  by  a  single  solution 
control  discipline  statement.  In  output  requests,  therefore,  the  subcases  for 
which  output  is  desired  must  be  explicitly  selected.  This  is  presented  in 
greater  detail  in  Subsection  5.5  and  in  Section  VII. 

5.4.7  "BWVST"  PiscjpUne  Optfops 

The  BLAST  discipline's  solution  control  is  very  similar  to  that  of  the 
TRANSIENT  discipline.  It  must  have  time  steps  specified  in  the  solution 
control  through  the  TSTEP  option  but,  unlike  the  normal  transient  response, 
DLOAD  ic  not  used  to  generate  the  load.  Instead,  the  BLCOND  option  is  used  to 
select  a  blast  condition  defined  on  a  BLAST  bulk  data  entry.  As  with  the 
other  dynamic  response  disciplines,  there  are  no  associated  design  con¬ 
straints.  These  two  options  completely  specify  the  BLAST  analysis. 

In  ASTROS,  each  time  step  for  which  output  is  saved  is  considered  to 
be  a  separate  subcase.  It  is  important  to  note  that,  like  the  MODES  disci¬ 
pline,  more  than  one  subcase  is  represented  by  a  single  solution  control 
discipline  statement.  In  output  requests,  therefore,  the  subcases  for  which 
output  is  desired  must  be  explicitly  selected.  This  is  presented  in  greater 
detail  in  Subsection  5.5  and  in  Section  VII. 

5.5  OUTPUT  REQUESTS 

Most  analysis  disciplines  in  ASTROS  have  response  quantities 
(displacements,  stresses,  strains,  etc.)  computed  at  either  node  points, 


65 


structural  elements  or  aerodynamic  elements.  The  user  can  select  that  these 
results  be  written  to  the  print  (output)  file  through  the  PRINT  command  and 
its  associated  options  or  written  to  a  punch  file  through  the  PUNCH  command. 
In  addition,  there  are  a  number  of  solution  control  commands  that  can  be  used 
to  label  the  output.  This  subsection  documents  the  PRINT  and  PUNCH  commands 
and  the  labeling  commands  and  discusses  their  use.  The  PRINT  and  PUNCH 
commands  are  identical  in  form  and  interpretation,  so  the  PRINT  command  will 
be  used  to  represent  both  commands  in  the  following  discussion.  There  are 
also  many  features  and  utilities  available  to  the  user  to  obtain  output 
through  modifications  to  the  executive  (MAPOL)  sequence.  These  include  direct 
use  of  MAPOL  utilities,  modification  of  print  parameters  in  functional  module 
calling  sequences  and  user  written  procedures  or  modules.  These  output  capa¬ 
bilities  and  a  more  complete  discussion  of  the  output  processing  (PRINT  and 
PUNCH)  capabilities  of  the  ASTROS  system  is  presented  in  Section  VII  of  this 
manual.  The  reader  is  referred  to  Appendix  D  for  the  complete  PRINT  and  PUNCH 
command  definitions. 

The  PRINT  and  PUNCH  commands  have  a  number  of  options  which  can  be 
separated  into  three  groups:  subcase  options,  response  quantity  options  and 
form  options.  The  subcase  options  select  a  set  of  subcases  to  which  the  PRINT 
command  applies  while  the  remaining  options  select  the  actual  data  quantities 
that  are  desired  (e.g.  stresses,  strains,  and  displacements)  and  the  form  in 
which  complex  quantities  are  to  be  printed.  The  output  selection  can  appear 
at  any  level  and  of  the  solution  control  hierarchy  and  will  apply  at  that 
level  and  below  until  it  is  overridden.  When  more  than  one  discipline  is 
covered  by  a  print  request  at  the  boundary  level,  ASTROS  will  consider  only 
the  relevant  print  requests  for  each  discipline.  For  example,  if  statics  and 
flutter  are  performed,  the  statics  discipline  will  ignore  any  ROOTS  requests 
and  the  flutter  discipline  will  ignore  any  STRESS  requests. 

5.5.1  Subcase  Options 

As  explained  in  the  preceding  subsections,  some  disciplines  have  more 
than  one  "subcase"  per  solution  control  statement.  Others,  like  STATICS  and 
SAERO  have  a  separate  solution  control  statement  for  each  subcase.  When  one 
subcase  is  defined  per  statement,  the  user  is  free  to  modify  the  print  re¬ 
quests  from  subcase  to  subcase;  for  example: 
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ANALYZE 


BOUNDARY  SPC  -  10 

STATICS  (  MECH  -  10  ) 

PRINT  STRESS  -  ALL,  DISP  -  100 
STATICS  (  MECH  -  20,  GRAV  -  100  ) 

PRINT  DISP  -  ALL 

specifies  that  stresses  for  all  elements  and  displacements  for  nodes  listed  in 
set  100  be  printed  for  the  first  subcase  (mechanical  loads  with  set  identifi¬ 
cation  10)  and  only  the  displacements  be  printed  for  the  next  load  condition. 
When  the  discipline  generates  more  than  one  subcase,  however,  the  user  MUST 
specify  the  subcases  to  which  the  PRINT  request  applies.  For  example: 

ANALYZE 


BOUNDARY  SPC  -  10,  METHOD  -  1000 


MODES 


PRINT  DISP  -  100,  MODES  -  ALL 


selects  that  displacements  (eigenvectors)  for  all  the  computed  mode  shapes  be 
printed.  If  the  MODES  ■=  ALL  selection  was  not  included  in  the  PRINT  state¬ 
ment,  the  user  would  get  NO  output.  The  user  is  cautioned  that  the  output 
processing  in  ASTROS  is  designed  to  limit  output  to  those  quantities  that  are 
explicitly  selected  and,  therefore,  the  default  for  subcase  option  MODES  is 
that  no  modes  are  selected.  Whenever  multiple  subcases  are  generated  by  a 
discipline  (MODES,  TRANSIENT,  FREQUENCY  and  BLAST)  a  subcase  selection  option 
is  REQUIRED  on  the  PRINT  command  in  order  to  get  anv  output.  The  subcase 
options  in  ASTROS  are: 


FREQUENCY 


MODE 


TIME 


Selects  the  frequency  steps  of  frequency  response 
disciplines  at  which  output  is  desired  by  refer¬ 
encing  a  FREQLIST  bulk  data  entry. 

Selects  the  eigenvectors  of  a  normal  modes  disci¬ 
pline  at  which  output  is  desired  by  referencing  a 
MODELIST  bulk  data  entry. 

Selects  the  time  steps  of  transient  response  and 
blast  analyses  at  which  output  is  desired  by 
referencing  a  TIMELIST  bulk  data  entry. 
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5. 5.2  Response  Quantity  Options 


ASTROS  is  able  to  compute  a  number  of  response  quantities  for  each 
discipline  type.  Each  discipline  type  generates  a  different  set  of  quantities 
so  that  the  quantity  selected  by  a  particular  keyword  can  sometimes  change 
from  one  discipline  to  another.  In  addition,  the  available  quantities  are  a 
sometimes  a  function  of  the  boundary  condition  type.  For  example,  the  flutter 
mode  shape  is  not  available  as  an  output  from  a  flutter  analysis  performed  in 
the  OPTIMIZE  subpacket.  This  subsection  presents  the  available  quantities, 
the  PRINT  options  which  select  them  and  the  limitations  (if  any)  on  their 
availability. 

The  following  PRINT  and  PUNCH  response  quantity  options  are  available: 


PRESSURE 

VELOCITY 

DISPLACEMENTS 

ENERGY 

GPFORCE 

LOAD 

SPCFORCE 

STRESS 

ACCELERATION 

STRAIN 

ROOT 

DESIGN 

DCONSTRAINT 

TRIM 


Selects  pressures  at  aerodynamic  boxes. 

Selects  velocities  at  nodal  points. 

Selects  displacements  at  nodal  points. 

Selects  strain  energy  at  structural  elements. 

Selects  grid  point  forces  at  nodal  points. 

Selects  applied  loads  at  nodal  points. 

Selects  forces  of  single  point  constraint  at  nodal 
points . 

Selects  stresses  at  structural  elements. 

Selects  accelerations  at  nodal  points. 

Selects  strains  at  structural  elements. 

Selects  eigenvalues  for  flutter  and  normal  modes. 

Selects  local  and  global  design  variable  values  at 
each  iteration. 

Selects  active  constraints  at  each  iteration. 

Selects  trim  and  stability  coefficients  for  steady 
aeroelastic  analyses. 


As  in  NASTRAN,  stresses,  strains  and  element  forces  are  computed  in 
the  element  coordinate  system  at  predetermined  or  user  selected  points  and 
nodal  quantities  are  computed  in  the  global  coordinate  system.  DESIGN  and 
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DCONSTRAINT  prints  are  only  applicable  in  the  OPTIMIZE  subpacket  and,  as 
previously  stated,  the  DISP  option  for  flutter  analyses  is  only  applicable  in 
the  ANALYZE  subpacket.  All  other  options  are  available  independent  of  the 
boundary  condition  type.  Table  7  presents  a  matrix  of  response  quantity 
options  for  each  discipline  type,  showing  the  applicability  of  each  option. 
Any  requests  for  quantities  that  do  not  apply  to  the  particular  discipline 
will  be  ignored  by  the  output  processor  without  warning. 

Most  options  can  be  ALL,  NONE  or  an  integer  value  which  select  bulk 
data  entry  sets  listing  the  items  for  which  the  response  quantity  is  desired. 
For  example,  the  STRESS  option  points  to  the  ELEMLIST  bulk  data  entity  which 
lists  the  elements  for  which  stresses  are  desired.  The  NONE  option  is  used  to 
override  a  default  established  through  a  print  or  punch  request  at  a  higher 
level  in  the  hierarchy.  The  ASTROS  output  philosophy  is  similar  to  that  of 
NASTRAN  in  that  it  is  assumed  that  mistakes  in  the  output  requests  should  not 
terminate  execution.  If,  for  example,  the  requested  structural  element  does 
not  exist  in  the  model,  the  output  request  will  be  ignored  without  any  warning 
to  the  user.  Other  output  request  errors  in  ASTROS  are  treated  in  a  similar 
manner,  occasionally  generating  a  warning  message,  but  more  typically  result¬ 
ing  in  no  visible  indication  that  the  request  was  in  error.  Therefore  the 
user  can,  in  most  cases,  request  output  that  does  not  apply  to  the  discipline 
under  analysis,  for  entities  (nodes  or  elements)  which  do  not  exist  and/or  for 
subcases  that  are  not  defined  without  causing  termination  of  the  execution. 

5.5.3  Form  Options 

For  complex  response  quantities,  the  form  option  is  provided  to  select 
either  RECTANGUIAR  or  POLAR  form.  Rectangular  form  gives  the  cartesian 
components  of  the  quantity  in  the  rectangular  complex  plane  in  which  the  first 
number  represents  the  real  component  and  the  second  number  the  imaginary 
component.  Polar  form  gives  the  components  in  polar  coordinates  in  which  the 
first  number  represents  the  radial  distance  from  the  origin  (the  magnitude) 
and  the  second  represents  the  angular  displacement  from  the  real  coordinate 
axis  (the  phase  angle).  The  phase  angle  is  computed  in  degrees. 

The  form  can  be  specified  at  two  levels  as  parenthetical  "phrases" 
attached  to  the  print  or  punch  statement.  At  the  higher  level,  the  form 
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TABLE  7.  RESPONSE  QUANTITY  PRINT  OPTIONS  MATRIX 


OPTION 

STAT 

MODE 

SAERO 

FLUT 

TRANS 

FREQ 

BLAS 

PRESS 

— 

— 

X 

— 

— 

— 

— 

VELO 

— 

— 

— 

— 

X 

X 

X 

DISP 

X 

X 

X 

xi 

X 

X 

X 

ENERGY 

X 

X 

X 

— 

X 

— 

X 

FORCE 

X 

X 

X 

— 

X 

— 

X 

GPFORCE 

X 

— 

X 

— 

— 

— 

— 

LOAD 

X 

— 

X 

— 

X 

X 

X 

SPCFORCE 

X 

— 

X 

— 

— 

— 

— 

STRESS 

X 

X 

X 

— 

X 

... 

X 

ACCEL 

X2 

— 

X2 

X 

X 

X 

STRAIN 

X 

X 

X 

— 

X 

— 

X 

ROOT 

— 

X3 

— 

X3 

— 

... 

— 

TRIM 

— 

— 

X 

— 

— 

— 

X 

NOTES:  1.  Flutter  displacements  (mode  shapes)  are  only  available  for 

analysis  and  then  only  if  a  flutter  crossing  is  found. 

2.  The  accelerations  are  available  for  STATICS  with  inertia  relief 
and  all  SAERO  analyses. 

3.  ROOTS  will  print  real  eigenvalue  extraction  summary  data  for 
MODES  and  complex  eigenvalues  for  FLUTTER. 


70 


option  generates  a  default  for  the  entire  print  or  punch  statement.  For 
example : 

PRINT  (POLAR)  STRESS  -  ALL,  STRAIN  -  ALL 

requests  that  polar  form  be  used  for  both  stress  and  strain  response  quanti¬ 
ties.  In  addition,  the  form  option  can  be  attached  to  the  individual  quantity 
options  to  override  the  print  default.  For  example: 

PRINT  (POLAR)  STRESS  -  ALL,  STRAIN  (  RECT  )  -  ALL 

overrides  the  polar  default  for  the  strain  output.  At  both  levels,  the 
default  form  is  rectangular  and  any  polar  requests  for  real  output  quantities 
are  ignored. 

5.5.4  Labeling  Options 

Labeling  of  printed  output  is  performed  through  the  use  of  three 
optional  commands  identical  in  form  to  their  NASTRAN  counterparts: 

TITLE  -  A  title  header  that  will  appear  as  the  first  line  on 

each  page  of  output. 

SUBTITLE  -  A  secondary  header  that  will  appear  on  the  second  line 
of  each  page  of  output. 

LABEL  -  A  tertiary  header  that  is  typically  used  to  identify 

subcase  (discipline  level)  output. 

Each  of  these  commands  can  appear  at  any  level  in  the  solution  control  hierar¬ 
chy  and  will  be  applied  until  superseded. 


SECTION  VI 


THE  BULK  DATA  PACKET 

The  bulk  data  packet  provides  the  ASTROS  system  with  the  engineering 
data  needed  to  perform  the  specific  tasks  requested  by  the  user.  It  contains 
the  model  geometries  for  the  structural  model,  the  aerodynamic  model (s)  and 
the  design  model  as  well  as  the  pool  of  data  from  which  the  solution  control 
requests  are  made.  Specialized  information  required  by  the  analysis 
disciplines  (e.g.,  Mach  number  and  reduced  frequency  pairs  for  unsteady 
aerodynamic  analyses)  is  also  provided  to  the  system  through  the  bulk  data 
packet.  The  basic  input  item  is  the  bulk  data  entry  which  is  directly  analo¬ 
gous  to  the  NASTRAN  bulk  data  "card."  In  fact,  NASTRAN  compatible  formats  were 
chosen  for  the  ASTROS  oulk  data  entries  whenever  possible  because  modern 
structures  are  often  analyzed  using  large  NASTRAN  finite  element  models  having 
tens  of  thousands  of  lines  of  bulk  data.  Further,  these  large  models  are 
usually  prepared  using  software  designed  specifically  to  generate  NASTRAN 
models.  Thus,  by  utilizing  NASTRAN  bulk  data  structures  where  possible  and  by 
using  NASTRAN's  bulk  data  style  for  the  additional  engineering  data,  ASTROS  is 
highly  compatible  with  existing  NASTRAN  models  and  with  current  finite  element 
model  generation  methods. 

Just  as  in  NASTRAN,  the  bulk  data  packet  begins  with  the  keyword  BEGIN 
BULK  (which  may  be  abbreviated  BEGIN)  and  is  terminated  by  the  optional 
keyword  ENDDATA  or  by  the  end  of  the  input  stream.  The  intervening  bulk  data 
entries  can  appear  in  any  order.  An  alphabetically  sorted  listing  of  the  bulk 
data  input  will  be  echoed  to  the  output  file  unless  suppressed  by  the  user 
through  a  MAPOL  sequence  modification  to  the  IFP  argument  list.  Similar 
modifications  to  the  IFP  call  may  select  that  the  sorted  bulk  data  be  written 
to  the  punch  file  for  use  in  post-processors,  be  echoed  unsor*"ed  or  be  written 
to  both  the  punch  file  and  the  output  file. 

All  the  input  entries  are  interpreted  by  IFP  through  "templates"  that 
are  defined  as  part  of  the  system  generation  task.  The  templates  provide  for 
basic  error  checking,  establish  defaults  and  direct  the  placement  of  '  e  raw 
data  onto  the  data  base.  The  use  of  templates  allows  additional  en-  ,  '<  r-  be 
added  to  the  system  very  simply  without  — ft.ware  changes.  The  de,f,i.ui  rv.rn  of 
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the  templates  and  the  means  of  adding  new  entries  are  documented  in  the 
Programmer's  Manual.  In  addition,  the  complete  listing  of  ASTROS  bulk  data 
templates  is  included  in  the  output  summary  generated  by  the  SYSGEN  system 
generation  utility  during  the  creation  of  the  system  data  base  files. 

On  typical  restart  runs,  the  user  must  be  sure  to  call  the  IFP  module 
in  the  executive  sequence  (even  if  there  is  no  bulk  data  packet)  to  ensure 
that  the  proper  data  base  environment  is  established  prior  to  calling  any 
additional  engineering  modules.  Obviously,  certain  user  written  MAPOL 
sequences  will  not  require  that  IFP  be  called.  On  restart  with  a  bulk  data 
packet  in  the  input  stream,  the  IFP  module  will  append  the  new  data  onto  the 
data  from  the  previous  run(s).  There  is  no  provision  for  deleting  existing 
bulk  data  except  through  MAPOL  sequence  modifications.  This  restart  feature, 
while  limited,  can  be  useful  in  many  instances;  e.g.  when  additional  analysis 
disciplines  are  desired  or  when  different  output  requests  are  desired. 

The  remainder  of  this  section  presents  the  structure  of  the  bulk  data 
entry  for  ASTROS  and  discusses  some  features  of  the  IFP  module  that  are  useful 
to  the  general  user.  ASTROS  bulk  data  entries  have  been  carefully  designed  to 
be  NASTRAN  compatible,  so  the  NASTRAN  User's  Manual  (Reference  2)  has  provided 
much  of  the  information  in  the  following  discussion  as  well  as  having  directed 
the  design  of  the  IFP  software.  The  reader  is  also  referred  to  the  ASTROS 
Programmer's  Manual  for  more  information  on  the  IFP  module  and  for  information 
on  the  addition  of  new  bulk  data  entries.  An  additional  resource  is  the 
MSC/NASTRAN  Primer  (Reference  3) . 

6.1  FORMAT  OF  THE  BULK  DATA  ENTRY 

Each  bulk  data  entry  consists  of  a  required  "parent"  line  followed  by 
a  number  of  optional  "continuation"  lines.  Therefore,  a  single  bulk  data 
entry  resides  on  one  or  more  lines.  The  bulk  data  line  has  one  mnemonic  field 
of  eight  characters  followed  by  either  eight  data  fields  of  eight  characters 
or  by  four  data  fields  of  16  characters  and  terminates  with  an  eight  character 
continuation  field  as  shown  in  Figure  5.  The  data  field  size  (either  eight  or 
16  characters)  is  determined  by  the  presence  of  the  optional  "large  field 
marker"  in  the  first  mnemonic  field  of  each  bulk  data  line.  The  parent  line 
begins  with  a  character  mnemonic  identifying  the  entry  followed  by  4  or  8  data 
fields  and  ending  with  a  continuation  field.  The  continuation  lines  are 
identical  except  that  the  leading  mnemonic  field  contains  a  continuation 
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label  which  is  used  to  link  it  to  its  parent  line.  This  structure  is 
identical  to  that  in  NASTRAN.  One  important  exception  to  NASTRAN  compatibili¬ 
ty  is  that  ASTROS  requires  that  the  continuation  lines  follow  continuously 
from  the  parent  line  although  the  bulk  data  entries  themselves  can  be  in  any 
order.  Random  placement  of  continuations  in  NASTRAN  is  an  artifact  from  using 
physical  cards  that  were  punched  with  the  bulk  data.  If  the  card  deck  were 
dropped,  the  resulting  random  order  still  had  to  be  interpretable  by  the  code. 
This  feature  no  longer  needs  to  be  supported  in  light  of  modern  computer 
storage  methods  but  NASTRAN  compatibility  dictated  that  similar  continuation 
labeling  be  used. 

A  continuation  line  is  defined  for  a  bulk  data  entry  that  requires 
more  than  eight  (or  four  large)  data  fields.  The  last  field  of  the  parent 
line  is  used  in  conjunction  with  the  first  field  of  the  continuation  line  as 
an  identifier.  The  parent  continuation  field  can  contain  any  alphanumeric 
entry  while  the  first  field  of  the  continuation  line  contains  a  plus  (+)  as  a 
continuation  character  in  column  1  followed  by  the  last  7  characters  from  the 
parent  continuation  label.  For  the  parent  line,  the  large  field  marker  is  an 
asterisk  (*)  following  the  name  of  the  entry  and  signifies  that  large  data 
fields  are  to  be  used.  For  continuation  lines,  the  asterisk  used  as  the 
continuation  character  plays  the  role  of  the  large  field  marker  as  shown  in 
Figure  5.  Each  bulk  data  line  must  be  either  all  narrow  field  or  all  large 
field,  although  separate  lines  of  a  single  bulk  data  entry  can  have  different 
field  widths  simply  by  using  the  proper  field  marker.  This  means  that  the 
same  bulk  data  entry  in  wide  and  narrow  formats  are  functionally  identical 
with  no  need  for  separate  templates.  Unlike  NASTRAN,  the  continuation  mnemon¬ 
ics  need  not  be  unique  among  all  the  bulk  data  entries  in  the  bulk  data  packet 
since  there  is  no  provision  for  randomly  sorted  continuations. 

The  input  on  a  bulk  data  line  can  either  be  in  fixed  format,  in  which 
each  item  must  reside  within  the  field  to  which  it  belongs,  or  in  free  format, 
in  which  fields  are  separated  by  commas  and  can  be  positioned  anywhere  to  the 
left  of  the  column  in  which  the  fixed  field  would  normally  start.  Free  format 
input  is  indicated  by  the  appearance  of  a  comma  in  the  first  10  characters  of 
the  input  line.  ASTROS  requires  that  each  line  (not  each  bulk  data  entry)  be 
either  all  fixed  or  all  free  format  and  that  each  free  format  field  be  sepa¬ 
rated  by  a  comma.  The  NASTRAN  use  of  a  blank  character  as  a  field  separator 
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(a)  Small  Field  Entry  with  a  Small  Field  Continuation 


mnemonic  data  data  data  data  data  data  data  data  mnemonic 


(b)  Small  Feld  Entry  with  a  Large  Field  Continuation 


mnemonic  data  data  data  data  data  data  data  da,a  mnemonic 


(c)  Large  Field  Entry  with  a  Small  Field  Continuation 

data  data 


mnemonic 


data 


data 


mnemonic 


NAME  * 


ABC 


♦  BC 


DEF 


(d)  Large  Field  Entry  with  a  Large  Fie  d  Continuation 


mnemonic  data  data  data  data  mnemonic 


NAME  * 

-1C  ^ 

ABC 

*  BC 

◄ -  16  - ► 

^  _  1  c  _ 

Figure  5.  Bulk  Data  Entry  Format 
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is  not  supported.  When  free  format  input  is  used,  the  continuation  lines  can 
reside  on  the  same  physical  line  of  input  with  the  continuation  labels  either 


included  or  not, 

as 

in  the 

following 

equivalent  examples 

MKAER01 , 

i. 

,  0.3, 

0.5,  ,  ,  , 

,  ABC  ,  +BC,  0.01, 

0.05 

MKAER01 , 

i. 

,  0.3, 

0.5,  ,  ,  , 

,  ,  0.01,  0.05,  0.1, 

0.2 

In  the  latter  case,  ASTROS  will  automatically  generate  the  missing  continua¬ 
tion  mnemonics.  Care  must  be  taken,  however,  that  the  first  TWO  data  fields 
of  the  continuation  line  be  non-blank.  If  not,  there  is  an  ambiguity  as  to 
whether  the  first  continuation  field  constitutes  a  continuation  label  or  a 
data  field.  This  ambiguity  causes  the  IFP  to  terminate  execution  with  an 
error  indicating  that  there  is  a  missing  continuation  line.  Free  format  input 
in  which  the  parent  and  continuation  lines  are  broken  into  separate  physical 
lines  or  which  explicitly  include  the  continuation  mnemonics  do  not  suffer 
this  limitation.  Free  format  input  is  further  restricted  in  that  the  break 
between  physical  lines  (if  needed)  must  occur  at  a  break  in  the  logical  line; 
i.e.,  the  split  must  occur  between  the  ending  continuation  field  on  the 
current  logical  line  and  the  continuation  field  of  the  next  logical  line. 
This  means,  for  the  preceding  example,  that  the  first  example  entry  could  be 
broken  into  two  lines  between  the  ABC  and  +BC  fields  but  nowhere  else.  When 
an  entry  is  broken  into  multiple  physical  lines,  the  continuation  mnemonics 
must  be  supplied.  Obviously,  fixed  format  input  requires  continuation  mnemon¬ 
ics  for  any  bulk  data  entries  having  continuation  lines. 

6.2  DATA  FIELD  FORMATS 

The  interior  fields  of  a  bulk  data  line  can  contain  either  integer 
data,  real  data,  character  data  or  certain  combinations  (e.g.  either  integer 
or  real  data).  The  template  for  each  entry  defines  which  type(s)  of  data  are 
acceptable  in  each  field.  Each  data  item  is  limited  to  the  number  of  charac¬ 
ters  that  fit  in  the  length  of  the  field;  i.e.,  for  narrow  width  fields  no 
more  than  eight  characters  can  be  used  in  the  data  item.  Unlike  NASTRAN,  any 
extra  characters  will  spill  to  the  next  field  and  will  result  in  IFP  errors; 
i.e.,  there  is  no  provision  for  rounding  real  data  to  fit  the  field  size. 

In  order  to  be  considered  valid,  the  data  item  must  first  satisfy  the 
data  type  requirement  as  specified  on  the  template.  Real  numbers,  including 
zero,  must  contain  a  decimal  point,  although  there  are  a  number  of  formats 
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supported.  For  example,  the  real  number  3.1  may  be  encoded  as  shown  or  as 
3.1E0,  +3.1D00,  0.31E1,  3.1+0,  etc.  Unlike  NASTRAN,  however,  there  CANNOT  be 
imbedded  blanks  anywhere  in  the  real  number  and  a  "D"  edit  descriptor  is 
treated  as  a  single  precision  number  until  actually  loaded  to  a  double  preci¬ 
sion  relational  attribute.  Blank  fields  that  do  not  have  other  defaults 
specified  on  the  template  will  be  interpreted  as  blank  characters,  an  integer 
zero  or  a  real  zero,  as  required.  Integer  values  must  be  formed  from  the  ten 
decimal  digits  with  an  optional  leading  plus  or  minus  sign.  Character  data 
consist  of  any  combination  of  alphanumeric  characters  including  any  digits, 
decimal  points,  etc.,  with  no  restriction  that  the  first  character  be  alpha¬ 
betic  . 

6.3  ERROR  CHECKING  IN  THE  INPUT  FILE  PROCESSOR 

As  mentioned  in  the  preceding  subsection,  the  IFP  module  performs 
basic  error  checking  to  ensure  that  the  input  data  are  of  the  correct  type. 
In  addition,  the  templates  provide  for  error  checks  that  enable  the  IFP  to 
check  that  the  data  satisfy  particular  requirements.  For  example,  the  IFP  can 
be  directed  to  require  that  a  particular  value  be  greater  than  zero  or  be  one 
of  a  finite  number  of  selections.  At  its  most  complex,  the  bulk  data 
processor  checks  to  ensure  specific  relationships  among  data  on  a  single  bulk 
data  entry.  It  is  important  to  understand,  however,  that  no  error  checks 
occur  in  the  IFP  to  ensure  that  references  to,  and  interrelationships  among, 
multiple  bulk  data  entries  are  satisfied.  These  more  complex  checks  occur  in 
subsequent  engineering  modules.  A  complete  description  of  the  available 
template  error  checks  and  the  mechanism  provided  to  add  additional  error 
checks  is  presented  in  the  Programmer's  Manual.  The  reader  may  find  it 
helpful  to  study  this  documentation  since  the  bulk  data  packet  and  the  bulk 
data  entries  are  closely  linked  to  the  software  in  both  the  SYSGEN  utility  and 
the  IFP  module. 

6.4  BULK  DATA  ENTRY  SUMMARY 

This  section  contains  a  summary  of  all  the  bulk  data  entries  in  the 
ASTROS  system  separated  into  logically  related  groups.  The  groups  are  com¬ 
posed  of  either  model  definition  entries,  subcase  definition  entries  or 
general  list  entries.  Appendix  E  contains  the  detailed  description  of  each  of 
the  entries  listed  in  this  section.  Each  bulk  data  entry  is  labeled  either 
"(N)ew",  "(C)hanged"  or  " (U)nchanged"  relative  to  its  NASTRAN  counterpart. 


« 


J 


« 


j 


« 
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Section  6.5  discusses  the  differences  between  NASTRAN  and  ASTROS  for  those 
entries  that  have  been  changed  or  are  completely  different  than  in  NASTRAN  but 
that  use  the  same  mnemonic  and  serve  a  similar  purpose. 

6.4.1  Aerodynamic  Load  Transfer 

ATTACH  (N)  Rigid  load  transfer  definition. 

SET1  (U)  A  structural  grid  point  list  for  spline  interpolation 

or  a  mode  list  for  omitting  normal  modes  in  flutter 
analysis . 

SET2  (U)  Structural  grid  point  list  in  term  of  aerodynamic 

macroelements . 

SPLINE1  (U)  Surface  spline  definition  for  out-of-plane  motion. 

6.4.2  Applied  Dynamic  Loads 

DLAGS  (N)  Time  and  phase  lag  definition  for  a  spatial  load. 

DLOAD  (U)  Linear  combination  of  dynamic  load  sets. 

DLONLY  (N)  Direct  definition  of  dynamic  spatial  load. 

GUST  (C)  Stationary  vertical  gust  definition. 

RL0AD1  (C)  Frequency  dependent  dynamic  load  definition. 

RL0AD2  (C)  Frequency  dependent  dynamic  load  definition. 

TABLED1  (C)  Tabular  function  definition  for  dynamic  load  genera¬ 

tion. 

TL0AD1  (C)  Time  dependent  dynamic  load  definition. 

TL0AD2  (C)  Time  dependent  dynamic  load  definition. 

6.4.3  Applied  Static  Loads 

FORCE  (U)  Definition  of  a  concentrated  load  at  a  grid  point. 

F0RCE1  (U)  Definition  of  a  concentrated  load  at  a  grid  point. 

GRAV  (U)  Definition  of  an  acceleration  vector  for  gravity  loads. 

LOAD  (U)  Definition  of  linear  load  combinations. 

MOMENT  (U)  Definition  of  a  moment  at  a  grid  point. 

M0MENT1  (U)  Definition  of  a  moment  at  a  grid  point. 

PLOAD  (U)  Definition  of  a  pressure  load  over  an  area. 

TEMP  (U)  Definition  of  a  temperature  at  a  structural  node. 

TEMPD  (U)  Definition  of  default  nodal  temperatures. 

6.4.4  Boundary  Condition  Constraints 

ASET  (C)  Analysis  set  definition. 

(C)  Analysis  set  definition. 


ASET1 


6.4.5 


DYNRED 


JSET1 


MPCADD 


0MIT1 


SPCADD 

SUPORT 


(N)  Dynamic  reduction  parameters. 

(N)  Inertia  relief  mode  shape  parameter  definition. 

(N)  Inertia  relief  mode  shape  parameter  definition. 

(U)  Multipoint  constraint  definition. 

(U)  Definition  of  combinations  of  MPC  sets. 

(C)  Omit  set  definition. 

(C)  Omit  set  definition. 

(U)  Single  point  constraint/enforced  displacement  defini¬ 
tion. 

(U)  Single  point  constraint  definition. 

(U)  Definition  of  combinations  of  SPC  sets. 

(C)  Definition  of  coordinates  for  determinate  reactions. 


DCONALE 

DCONCLA 

DCONDSP 

DCONFLT 

DCONFRQ 

DCONSTR 

DCONTHK 


(N)  Aileron  effectiveness  constraint  definition. 

(N)  Lift  effectiveness  constraint  definition. 

(N)  Displacement  constraint  definition. 

(N)  Flutter  constraint  definition. 

(N)  Modal  frequency  constraint  definition. 

(N)  Stress/strain  constraint  definition. 

(N)  Thickness  constraint  definition  for  use  with  shape 
function  design  variable  linking. 


6.4.6 


Variables 


timization  Parameters 


DESELH  (N)  Unique  physical  design  variable  definition. 

DESVAR  (N)  Linked  physical  or  shape  function  design  variable 
definition. 

ELIST  (N)  Shape  function  definition. 

MPPARM  (N)  Mathematical  programming  default  parameter  override. 

PLIST  (N)  Physical  design  variable  linking  definition. 


6.4.7 


C0RD1C  (U)  Cylindrical  coordinate  system  definition. 

C0RD1R  (U)  Rectangular  coordinate  system  definition. 

CORDIS  (U)  Spherical  coordinate  system  definition. 
C0RD2C  (U)  Cylindrical  coordinate  system  definition. 

C0RD2R  (U)  Rectangular  coordinate  system  definition. 

C0RD2S  (U)  Spherical  coordinate  system  definition. 
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6.4.8 


6.4.9 


6.4.10 


6.4.11 


EPOINT 

(C) 

Extra  point  definition  for  dynamics. 

. 

GRDSET 

(U) 

Default  parameters  for  fields  on  the  GRID 

entry. 

GRID 

(U) 

Grid  point  location  and  coordinate  system 

selection. 

« 

SPOINT 

(U) 

Scalar  point  definition. 

' 

• 

' 

Material 

Pronerties 

: 

MATl 

(U) 

Isotropic  elastic  properties  definition. 

' 

i 

MAT2 

(U) 

Two-dimensional  anisotropic  properties  definition. 

MAT  8 

(U) 

Orthotropic  properties  definition. 

MAT9 

(U) 

Anisotropic  properties  definition  for 
hexahedral  elements. 

isoparametric 

« 

Miscellaneous 

Incuts 

$ 

(U) 

Commentary  data. 

1 

CONVERT 

(N) 

Conversion  factor  definitions. 

. 

■ 

i 

DMI 

(C) 

Direct  matrix  input. 

i 

DMIG 

(C) 

Direct  matrix  input  at  structural  nodes. 

MFORM 

(N) 

Mass  matrix  form  (LUMPED  or  COUPLED). 

SAVE 

(N) 

List  of  data  base  entities  not  to  be  purged. 

SEQGP 

(U) 

Structural  set  resequencing  definition. 

i 

OutDut  Selection  Lists 

•  *  •  1 

ELEMLIST 

(N) 

List  of  elements  *  element  dependent  output. 

FREQLIST 

(N) 

List  of  frequency  steps  for  which  output 

is  desired. 

• 

GRIDLIST 

(N) 

List  of  nodes  for  nodal  dependent  output. 

MODELIST 

<N) 

List  of  normal  modes  for  which  output  is 

desired. 

• 

TIMELIST 

(N) 

List  of  time  steps  for  which  output  is  desired. 

Steady  Aerodynamics 

_ _ 9 

AEROS 

(N) 

Reference  parameters. 

■ 

AEFACT 

(N) 

List  of  real  parameters. 

AELIST 

(N) 

List  of  aerodynamic  elements  (boxes). 

.  _  1 

AESURF 

(N) 

Aerodynamic  control  surface  definition. 

• 

AIRFOIL 

(N) 

Airfoil  property  definition. 

.  | 

AXSTA 

(N) 

Body  axial  station  parameter  definition. 

BODY 

(N) 

Body  configuration  definition. 

CAF.R06 

(N) 

Macroelement  (panel)  definition. 

• 

PER06 

(N) 

Body  parameter  definition. 
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6.4.12  Structural  Element  Connection 


BAROR 

(U) 

Definition  of  default  parameters  for  the  CBAR  bar 
element . 

CBAR 

(C) 

Prismatic  beam  element. 

CELASl 

(C) 

Scalar  elastic  spring  element. 

CELAS2 

(C) 

Scalar  elastic  spring  element. 

CIHEX1 

(U) 

Linear  isoparametric  hexahedral  element. 

CIHEX2 

<U) 

Quadratic  isoparametric  hexahedral  element. 

CIHEX3 

(U) 

Cubic  isoparametric  hexahedral  element. 

CMASS1 

(C) 

Scalar  mass  element. 

CMASS2 

(C) 

Scalar  mass  element. 

CONM1 

(U) 

Direct  6x6  mass  matrix  definition  at  a  structural 
node . 

COM2 

(C) 

Concentrated  mass  at  a  structural  node. 

CONROD 

(C) 

Rod  element. 

CQDMEM1 

(C) 

Isoparametric  quadrilateral  membrane  element. 

CQUAD4 

(C) 

Isoparametric  quadrilateral  element  with  bending  and 
membrane  stiffness. 

CROD 

(C) 

Rod  element. 

CSHEAR 

(C) 

Shear  panel. 

CTRMEM 

(C) 

Constant  strain  triangular  membrane  element. 

Structural 

Element, Properties 

PBAR 

(C) 

Prismatic  beam  element. 

PCOMP 

(C) 

Composite  laminate  definition  for  CQDMEM1,  CQUAD4,  and 
CTRMEM  elements . 

PCOMP1 

(N) 

Composite  laminate  definition  for  CQUAD4  elements. 

PCOMP2 

(N) 

Composite  laminate  definition  for  CQUAD4  elements. 

PELiiS 

(C) 

Scalar  elastic  spring  element. 

PIHEX 

(U) 

Linear,  quadratic  and  cubic  isoparametric  hexahedral 
element . 

PMASS 

(C) 

Scalar  mass  element. 

PQDMEM1 

(C) 

Isoparametric  quadrilateral  membrane  element. 

PROD 

(C) 

Rod  element. 

PSHEAR 

(C) 

Shear  panel . 

PSHELL 

(C) 

Definition  of  shell  element  properties  for  CQUAD4 
elements . 

PTRKEM 

(C) 

Constant  strain  triangular  membrane  element. 
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AERO  (C)  Reference  parameters . 

CAEROl  (U)  Aerodynamic  macroelement  (panel)  definition. 

CAER02  (U)  Body  configuration  definition. 

FLFACT  (U)  Parameter  definition  for  flutter  analysis. 

MKAER01  (C)  Table  of  symmetries,  Mach  numbers,  and  reduced  frequen¬ 
cies  . 

MKAER02  (C)  Table  of  symmetries,  Mach  numbers,  and  reduced  frequen¬ 
cies  . 

PAER01  (U)  Association  between  bodies  and  macroelements. 

PAER02  (U)  Body  cross-section  property  definition. 

6.4.15  Discipline  Dependent  Problem  Control 

The  following  bulk  data  entries  are  the  controlling  entries  referenced 
by  Solution  Control  in  selecting  specific  disciplines  and  subcases.  In  each 
case,  many  of  these  inputs  can  appear  in  the  bulk  data  packet  with  the  partic¬ 
ular  input  to  be  used  for  the  subcase  referenced  in  the  Solution  Control 
Packet . 

BLAST  (N)  Parameters  for  nuclear  blast  analyses. 

FLUTTER  (C)  Basic  parameters  for  flutter  analyses. 

TRIM  (C)  Flight  condition  for  steady  aeroelastic  trim  analyses. 

EIGR  (U)  Real  eigenvalue  extraction  parameters. 

FFT  (N)  Fast  Fourier  Transform  parameter  definition. 

FREQ  (U)  Frequency  step  definition  for  frequency  response. 

FREQ1  (U)  Frequency  step  definition  for  frequency  response. 

FREQ2  (U)  Frequency  step  definition  for  frequency  response. 

IC  (N)  Initial  condition  definition  for  direct  transient 

response  (same  as  NASTRAN  TIC  card) . 

TABDMP1  (C)  Modal  damping  table  for  modal  dynamic  response. 

TF  (U)  Dynamic  transfer  function  definition. 

TSTEP  (U)  Time  step  definition  for  transient  response. 

VSDAMP  (N)  Definition  of  viscous  damping  based  on  equivalent 
structural  damping. 

6 . 5  SUMMARY  OF  ASTROS  NASTRAN  BULK  DATA  ENTRY  DIFFERENCES 

The  bulk  data  entries  marked  "new"  in  the  preceding  subsection  do  not 
exist  in  the  MSC/NASTRAN  or  in  the  COSMIC/NASTRAN  versions  that  guided  the 


definition  of  the  bulk  data  entries.  Some  of  them  do  however,  exist  in  other 
NASTRAN  systems:  the  DYNRED,  JSET,  JSET1,  PC0MP1 ,  and  PC0MP2  entries  are 
examples.  Others  take  the  place  of  the  NASTRAN  "PARAM"  entry  which  had  been 
overused.  Examples  of  these  inputs  are  the  CONVERT,  MFORM  and  VSDAMP  entries. 
The  steady  aeroelastic  model  is  completely  new  to  ASTROS  since  NASTRAN  uses 
the  same  modeling  for  both  steady  and  unsteady  analysis.  Also,  the  NASTRAN 
mechanism  for  defining  dynamic  loads  was  needlessly  complicated.  Working  from 
the  NASTRAN  inputs,  a  simpler,  but  equally  general,  set  of  entries  was 
developed.  This  resulted  in  the  generation  of  a  number  of  new  entries  and  the 
modification  of  others.  The  definition  of  the  design  variables,  design 
variable  linking  and  the  design  constraints  is,  of  course,  completely  new  for 
ASTROS . 

The  majority  of  the  "changed"  entries  have  been  modified  to  accommo¬ 
date  the  design  task.  In  these  cases,  the  bulk  data  entry  is  often  identical 
to  the  NASTRAN  version  for  use  in  analysis  with  optional  additional  fields  to 
specify  the  design  data.  The  element  connectivity  and  property  entries  are 
all  examples  of  this  type  of  change  in  that  additional  field(s)  have  been 
added  to  specify  the  maximum  and  minimum  allowable  physical  design  variable 
value  if  shape  function  design  variable  linking  is  used.  In  cases  where  data 
from  NASTRAN  preprocessors  are  used,  there  are  no  changes  required  unless 
shape  function  linking  is  desired. 

A  more  subtle  set  of  changes  was  required  to  perform  multidisciplinary 
analysis  (which,  in  turn,  is  a  requirement  to  perform  useful  design 
optimization).  In  NASTRAN,  as  mentioned  in  the  discussion  of  the  Solution 
Control  packet,  many  parameters  were  specified  as  part  of  the  model  definition 
or  discipline  specification  because  the  code  was  limited  to  performing  a 
single  analysis  of  the  given  discipline.  In  order  to  remove  these  artificial 
restrictions,  these  data  have  been  moved  to  the  proper  discipline's  subcase 
definition.  Examples  of  this  form  of  modification  are  the  addition  of  symme¬ 
try  options  to  the  MKAEROi,  GUST,  FLUTTER,  and  TRIM  entries  and  the  removal  of 
subcase  dependent  data  from  the  AERO  entry.  Further,  the  ASETi,  OMITi  and 
EPOINT  entries  were  modified  to  include  a  set  identification  number  to  enable 
multiple  boundary  conditions  and  multiple  control  systems  to  be  analyzed 
simultaneously . 
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The  last  type  of  modification  came  about  because  of  the  nature  of  the 
ASTROS  data  base  management  system.  These  were  limited  to  the  DMI  and  DMIG 
entries  for  direct  loading  of  data  base  entities.  The  NASTRAN  inputs  were  not 
compatible  with  the  ASTROS  data  base  and  so  had  to  be  modified.  In  fact, 
these  entries,  while  having  the  same  name  as  a  NASTRAN  card,  are  completely 
new  entries  for  ASTROS.  A  minor  additional  modification  to  the  input  defini¬ 
tions  was  made  for  the  table  entries  (e.g.,  TABLEDD1  and  TABDMP1)  to  make  them 
more  compact  and  to  remove  the  useless  "ENDT"  table  termination  symbol.  In 
ASTROS,  all  tabular  input  entries  are  terminated  when  no  more  data  appeal's  and 
do  not  allow  a  specific  declaration  of  the  table  end. 

While  a  seemingly  large  number  of  bulk  data  entries  have  been  changed 
relative  to  their  NASTRAN  counterparts,  in  fact  only  a  few  have  been  changed 
in  such  a  way  that  the  NASTRAN  version  will  not  work  in  analysis.  By  far,  the 
majority  of  the  modeling  bulk  data  entries  are  completely  unchanged  except  for 
certain  design  variable  linking  options.  In  unsteady  and  steady  aerodynamic 
disciplines,  care  must  be  taken  to  account  for  the  subcase  dependencies  that 
NASTRAN  defined  implicitly  or  with  PARAM  cards.  Finally,  the  use  of  ASET  and 
OMIT  entries  will  cause  minor  problems  in  that  ASTROS  requires  a  set  identifi¬ 
cation  for  these  entries.  While  this  latter  restriction  can  require  some 
effort  to  fix,  the  gain  in  capability  mandated  that  the  bulk  data  entry  be 
modified. 

The  most  serious  potential  problem  using  NASTRAN  models  in  ASTROS  is 
that  the  set  of  bulk  data  entries  is  more  limited  in  ASTROS  than  in  NASTRAN. 
The  ASTROS  system  has  been  developed  , rimarily  as  a  multidisciplinary  prelimi¬ 
nary  design  tool  and  does  not  yet  contain  the  wide  range  of  options  supported 
by  a  mature  code  like  NASTRAN.  The  many  NASTRAN  input  entries  supporting 
these  options,  therefore,  have  not  been  defined  to  the  ASTROS  system  because 
they  are  not  supported  by  any  ASTROS  code.  Thus,  there  will  be  instances 
where  a  NASTRAN  input  deck  will  have  to  be  modified  to  remove  these  entries 
which  serve  no  purpose  in  ASTROS.  The  majority  of  these  bulk  data  entries 
deal  with  unsupported  elements,  plotting  options,  output  options,  etc.,  which 
are  not  felt  to  present  a  major  problem.  More  important  is  the  support  for 
NASTRAN' s  model  definitions,  most  of  which  have  already  been  adopted  by 
ASTROS.  One  exception  is  the  rigid  elements  like  COSMIC  NASTRANs  CRIGIDi  and 
MSC/NASTRAN ' s  RBAR,  RBE1 ,  and  RBE2  which  are  not  included  in  ASTROS.  It  is 
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anticipated  that  these  elements  may  present  a  problem  in  that  ASTROS  only 
accepts  multipoint  constraints  explicitly  defined  on  MPC  entries.  In  NASTRAN 
models  using  rigid  elements,  the  user  is  burdened,  therefore,  with  the  task  of 
manually  translating  the  rigid  elements  into  their  equivalent  MPC  entries. 
There  is,  however,  no  loss  of  functionality  in  ASTROS  since  rigid  elements  are 
only  a  convenience  and  do  not  represent  any  capability  that  is  not  provided  by 
the  raw  MPC  data. 
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SECTION  VII 


ASTROS  OUTPUT  FEATURES 

In  a  software  system  the  magnitude  of  ASTROS,  the  amount  of  data  that 
may  be  of  interest  to  the  user  is  very  large.  In  multidisciplinary 
optimization,  the  quantity  of  data  is  even  larger  and  the  expense  involved  in 
its  computation  significant.  It  is  worthwhile,  therefore,  to  limit  the  amount 
of  output  to  a  minimum  and  to  provide  a  mechanism  for  the  user  to  select  those 
data  that  are  of  importance  in  each  particular  case.  Section  V  of  this  report 
documented  one  mechanism  provided  in  ASTROS  to  select  particular  disciplines, 
subcases  and  response  quantities:  that  of  the  Solution  Control  output  re¬ 

quest.  This  section  endeavors  to  present  the  totality  of  output  options 
available  to  the  ASTROS  user.  The  system  controlled  outputs  from  the  engi¬ 
neering  modules  are  described  in  order  to  establish  a  familiarity  with  an 
ASTROS  output  listing.  This  is  followed  by  a  more  complete  description  of 
output  from  each  Solution  Control  request  than  is  contained  in  Section  V,  with 
different  disciplines,  elements,  design  constraints  and  node  types  accounted 
for  in  some  detail.  These  represent  the  outputs  that  are  fully  supported  by 
the  ASTROS  software  and  require  little  or  no  user  intervention  to  obtain.  The 
presentation  of  these  features  assumes  that  the  standard  executive  sequence 
is  used.  If  the  user  substantially  modifies  the  standard  sequence  (to  the 
point  where  certain  modules  are  not  called) ,  some  or  all  of  the  presented 
output  features  may  no  longer  be  available.  Some  of  the  documented  features 
have  not  been  implemented  in  the  initial  production  release  of  the  code. 
These  features  are  described  to  the  extent  that  hey  have  been  designed  and 
their  status  at  the  time  of  initial  release  is  noted. 

The  more  advanced  forms  of  user  output  requests  are  also  presented  in 
this  section.  The  most  basic  of  these  forms  involve  changing  the  engineering 
module  argument  lists  in  the  standard  executive  (MAPOL)  sequence  for  those 
modules  that  support  print  level  selection.  For  ASTROS,  the  defaults  (estab¬ 
lished  in  the  standard  sequence)  select  the  least  printed  output  in  each  case. 
Finally,  the  MAPOL  addressable  print  utilities  are  presented.  The  use  of 
these  utilities,  in  conjunction  with  the  general  versatility  of  the  MAPOL 
language,  provides  the  user  with  the  capacity  both  to  look  at  existing  data 
and  to  compute  and  view  additional  data.  In  fact,  these  options  enable  the 


user  to  obtain  (in  a  crude  format)  virtually  any  data  that  reside  on  the  data 
base  or  that  can  be  computed  and  stored  on  the  data  base. 


7.1  SYSTEM  CONTROLLED  OUTPUT 

Many  of  the  engineering  and  executive  system  program  units  write  data 
to  the  ASTROS  output  listing  automatically.  As  indicated  in  the  introduction 
to  this  section,  output  of  this  nature  in  ASTROS  is  very  limited,  but  suffi¬ 
cient  amounts  exist  to  justify  a  brief  presentation  of  the  data  and  their 
formats.  It  is  also  useful  to  present  the  basic  ASTROS  listing  in  order  to 
facilitate  contrasting  it  to  listings  containing  user  selected  output  quanti¬ 
ties.  The  first  page  of  ASTROS  output  is  the  title  page  showing  the  version 
number,  date  and  host  machine  of  the  user's  system.  Each  page  of  output 
following  the  solution  control  listing  will  be  labeled  with  six  lines  of 
header  information  including  the  user  selected  title,  subtitle  and  label.  The 
version  number,  date  and,  if  applicable,  the  design  iteration  number  will  also 
appear  in  the  header  of  each  page . 

7.1.1  Default  Output  Printed  by  Modules 

If  a  solution  control  packet  is  in  the  input  data  stream,  the  solution 
control  commands  will  be  echoed  to  the  output  listing  following  the  title 
page.  This  listing  is  helpful  in  identifying  the  particular  disciplines  and 
cases  ■'elected  in  the  run.  The  multidisciplinary  nature  of  ASTROS  requires 
further  output  labeling;  therefore,  in  addition  to  the  solution  control 
summary,  the  EDCASE  module  writes  a  summary  of  selected  disciplines  for  each 
boundary  condition  at  the  top  of  the  boundary  condition  loop.  It  indicates 
all  disciplines  and  most  discipline  options  in  the  current  boundary  condition 
in  order  to  assist  the  user  in  determining  the  particular  path  that  will  be 
taken  through  the  standard  MAPOL  sequence.  A  similar  print  (from  the  ABOUND 
module)  appears  at  the  top  of  the  sensitivity  phase  boundary  condition  loop  to 
indicate  the  nature  of  the  active  boundary  conditions  and  active  design 
constraints . 

Additional  active  constraint  information  is  provided  in  the  Active 
Constraint  Summary  from  the  ACTCON  module.  It  indicates  the  total  number  of 
constraints  considered  active  according  to  the  current  constraint  deletion 
criteria.  The  user  may  select  a  complete  listing  of  the  active  constraints 
through  the  PRINT  DCONSTRAINT  solution  control  option,  but  may  not  suppress 


88 


his  IlfPOftT  HAS  Mitt  DCUMITtD 

and  clcamd  poo  ^taic  rcliak 

Not*  ooo  oiofCTivf  5200.20  ilMD 

s  dgSTKtCTIOMt  AM  IMPOSED  tJPOM 
ITS  use  AND  01  SClOIMM . 

JiSTRiBUTiON  STATEMENT  A 

APPQOVfO  POO  PUOtlC  MuAAttl 

D I  STAIlUT  100  UNUOITfO. 


the  table  header  indicating  the  number  of  constraints  retained  of  the  total 
number  applied.  This  number  is  computed  even  if  the  current  design  is  consid¬ 
ered  to  be  the  converged  optimum.  A  summary  of  the  convergence  criteria  and 
of  the  critical  constraint  value  is  included  in  the  Active  Constraint  Summary 
header  if  the  approximate  problem  was  considered  converged  following  the 
preceding  redesign  step. 

Each  redesign  step  is  summarized  in  a  small  table  entitled  the  Approx¬ 
imate  Optimization  Summary.  It  indicates  the  optimization  method  used  (either 
fully  stressed  design  or  mathematical  programming)  and  the  change  in  the 
objective  function  during  the  solution  of  the  approximate  optimization  prob¬ 
lem.  It  also  echoes  the  values  of  the  two  approximate  problem  termination 
criteria:  the  absolute  objective  function  change  and  the  percent  change.  The 
status  of  the  (approximate  problem)  convergence  flag  following  the  redesign  is 
also  indicated. 

The  last  default  design  print  is  generated  by  the  ACTCON  module  on  the 
final  design  iteration.  The  ACTCON  module  prints  out  the  design  iteration 
history,  the  final  global  design  variable  values  and  the  final  local  design 
variable  values.  The  iteration  history  includes  statistics  summarizing  each 
approximate  optimization  problem  and  shows  the  increments  in  the  objective 
function.  The  global  design  variable  print  lists  the  final  values,  the  upper 
and  lower  bounds,  the  objective  sensitivity  to  the  design  variable,  the 
linking  option  used  and  a  user  label  identifying  the  global  design  variable. 
Finally,  the  local  variable  print  shows  the  actual  physical  value  represented 
by  the  final  design.  Also  included  are  element  dependent  values  (e.g.,  T/TMIN 
for  plate  elements  and  inertias  for  BAR  elements).  Both  the  global  and  local 
design  variable  prints  can  be  selected  at  all  iterations  through  the  Solution 
Control,  but  will  be  printed  on  the  final  iteration  irrespective  of  the  print 
selection.  A  more  complete  description  of  the  design  variable  print  formats 
is  contained  in  Subsection  7.2.3. 

The  final  default  outputs  are  a  trailer  indicating  the  status  of  the 
termination  (either  with  or  without  errors),  the  date  and  the  time  the  run  was 
completed  and  an  execution  timing  summary.  The  timing  summary  indicates  the 
CPU  time  spent  in  each  phase  of  the  execution.  Each  engineering  and  mathemat¬ 
ical  module  called  by  the  executive  system  is  listed  in  the  order  called  along 
with  an  indication  of  the  running  and  step  CPU  times.  Also,  the  elapsed  clock 
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Cine  is  shown  upon  leaving  each  nodule.  This  summary  is  useful  in  determining 
where  a  problem  may  have  occurred  and  in  confirming  that  the  proper  path  was 
taken  through  the  MAPOL  sequence.  It  is,  of  course,  also  useful  as  an  indica- 
tion  of  the  relative  CPU  costs  of  each  engineering  module. 

7.1.2  Error  Message  Output 

Error  messages  can  be  printed  from  virtually  all  the  modules  of  the 
ASTROS  system  as  well  as  from  the  data  base  management  software.  Data  base 
errors  should  not  occur  unless  the  user  has  modified  or  otherwise  written  a 
special  MAPOL  sequence,  incorrectly  assigned  file  names  or  used  other  incor¬ 
rect  or  inconsistent  data  base  information.  Typically,  data  base  errors  cause 
immediate  termination  of  the  execution.  The  system  administrator  should  be 
able  to  assist  in  solving  these  errors  which  will  most  likely  be  caused  by 
incorrect  use  of  the  system  or  by  incorrect  system  installation.  The  ASTROS 
Programmer's  Manual  contains  further  information  on  the  causes  of  particular 
data  base  errors . 

The  standard  ASTROS  error  messages  are  printed  by  the  UTMWRT  utility 
module  and  represent  error  checks  that  the  modules  are  coded  to  perform  or 
errors  that  may  cause  problems  in  the  current  module's  algorithm.  As  much  as 
possible,  these  error  messages  are  intended  to  be  standalone  in  that  the  user 
should  be  able  to  interpret  the  message  without  referring  to  the  Programmer's 
Manual.  There  are  four  different  levels  of  errors  that  can  occur  in  ASTROS, 
each  labeled  differently  when  printed: 

(1)  System  Fatal  Message 

These  messages  are  caused  by  errors  or  inconsistencies  in  the 
system  definitions.  Usually,  these  relate  to  erroneous  input  to 
the  system  generation  utility,  SYSGEN,  or  are  a  result  of  using 
an  outdated  system  data  base.  You  should  contact  your  system 
administrator  to  effect  a  correction.  Hopefully,  these  errors 
will  rarely  occur  and  should  never  occur  in  an  unmodified  ASTROS 
system. 


These  messages  are  written  when  the  system  encounters  data  that 
may  represent  an  input  error  or  may  later  generate  a  problem  but 
that  may  only  be  a  special  user  input  that  falls  outside  the 


expected  range.  Usually,  these  messages  can  be  ignored.  This  is 
the  least  serious  type  of  user  message  in  ASTROS. 


(3)  User  Warning  Message 

These  messages  are  written  when  the  system  encounters  data  that 
are  incorrect  but  which  may  not  cause  termination.  In  some 
cases,  this  level  of  error  is  used  to  signify  that  the  system 
will  continue  to  search  for  errors  but  will  terminate  abnormally 
following  the  search. 

(4)  User  Fatal  Message 

These  messages  are  written  when  the  system  encounters  data  that 
are  in  error  to  the  extent  that  continuation  is  impossible.  The 
system  will  terminate  execution  either  immediately  or  after  some 
minor  clean  up. 

If  the  user  is  unable  to  decipher  the  error  message,  the  following  steps  can 
help  determine  the  source  of  the  error: 

(1)  Check  the  timing  summary  against  the  MAPOL  sequence  path  to 
determine  which  module  generated  the  error  message.  Also,  check 
the  SYSGEN  output  to  determine  the  module  that  wrote  the  message. 
Note  that  the  "message  number"  is  included  in  the  error  message 
print  if  the  message  is  a  standard  one. 

(2)  Check  the  Programmer's  Manual  documentation  for  the  relevant 
module  to  determine  the  error  checks  it  performs  and  to  get 
further  information  on  the  source  of  the  error. 

7.2  QUANTITIES  SELECTED  THROUGH  SOLUTION  CONTROL  OPTIONS 

This  subsection  presents  a  detailed  description  of  the  output  quanti¬ 
ties  that  can  be  selected  through  the  solution  control  packet.  These  quanti¬ 
ties  fall  into  five  categories:  (1)  element,  (2)  nodal,  (3)  design,  (4) 

eigenvalues  for  flutter  and  normal  modes,  and  (5)  aeroelastic  trim  quantities. 
Each  of  these  categories  is  presented  in  the  separate  subsections  that  follow. 

The  PRINT  and  PUNCH  solution  control  commands  are  used  to  request  the 
desired  output  quantities.  These  commands  have  three  groups  of  options: 
subcase  options,  quantity  options  and  form  options.  These  options  are  fully 
described  in  Subsection  5.5  of  this  report,  but  one  point  must  be  stressed: 


subcase  options  play  an  extremely  important  role  in  ASTROS  output  requests. 
Subcase  options  allow  the  user  to  identify  the  set  of  subcases  to  which  the 
print  selection  will  apply.  This  selection  is  necessary  because  many  disci¬ 
plines  (MODES,  for  example)  generate  more  than  one  subcase  (e.g.,  eigenvector) 
with  a  single  solution  control  directive.  (The  critical  point  is  that  the 
default  selection  is  that  there  be  no  output.)  In  other  words,  if  there  are 
no  subcases  selected,  ASTROS  will  not  default  to  all  subcases.  Instead 
nothing  will  be  printed. 

Unlike  NASTRAN,  ASTROS  has  no  options  to  reorder  the  output.  The 
multidisciplinary  nature  of  ASTROS  completely  negates  the  utility  of  NASTRAN' s 
S0RT1  and  S0RT2  options,  and  any  other  sort  options  become  impossibly  complex 
very  quickly.  Instead,  a  reasonable,  fixed  sort  was  established  in  which  each 
boundary  condition  is  treated  separately  and  in  the  order  given  in  the  solu¬ 
tion  control  packet.  If  the  standard  sequence  is  used,  the  response  quanti¬ 
ties  will  appear  in  the  following  order  within  each  optimize  or  analyze 
boundary  condition: 

(1)  Steady  aerodynamic  trim  parameters. 

(2)  Flutter  roots  and  flutter  mode  shape  modal  participation  fac¬ 
tors  --  note  that  the  mode  shape  is  only  available  if  flutter  has 
occurred  and  if  the  FLUTTER  discipline  is  within  an  ANALYZE 
boundary  condition. 

(3)  Applied  load  print  requests. 

(4)  The  "displacement"  nodal  response  quantities:  DISPLACEMENTS, 

VELOCITIES,  and  ACCELERATIONS. 

(5)  Element  response  quantities  in  the  order:  stress,  strain,  force 
and  strain  energy  for  each  subcase.  Elements  are  processed 
alphabetically  within  each  quantity  type. 

In  the  OPTIMIZE  subpacket,  these  data  are  followed  by  the  selected  design  and 
resizing  prints  in  the  following  order: 

(6)  Active  constraint  summary  (either  the  default  abbreviated  print 
or  the  full  print  if  the  DCONSTRAINT  print  option  is  selected). 

(7)  The  print  of  the  global  and  then  local  design  variables  repre¬ 
senting  the  current  design  --on  the  final  design  iteration,  the 
iteration  history  precedes  the  design  variable  output. 
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Within  each  response  quantity's  print  module,  the  disciplines  are  not  treated 
in  the  order  given  in  the  solution  control  packet;  instead,  they  are  treated, 
where  applicable,  in  the  following  order: 

(A)  STATICS 

(B)  MODES 

(C)  SAERO 

(D)  FLUTTER 

(E)  TRANSIENT 

(F)  FREQUENCY 

(G)  BLAST 

The  subcases  within  each  discipline  are  treated  in  the  order  given  in  the 
solution  control  packet.  In  the  case  of  MODES,  the  eigenvectors  are  ordered 
in  increasing  eigenvalue  order.  TRANSIENT,  FREQUENCY,  and  BLAST  subcases  are 
ordered  in  increasing  time  or  frequency  step. 

7.2.1  Element  Response  Quantities 

B 

^  ASTROS  has  two  basic  forms  of  elements:  aerodynamic  elements  and 

structural  elements.  An  aerodynamic  element  is  defined  as  a  "box"  of  an 
aerodynamic  macroelement,  e.g.,  wing  component  or  fuselage  segment.  The 
nature  of  the  macroelement  varies  among  both  aerodynamic  models  and  among 
aerodynamic  components  within  each  model.  In  general,  however,  a  box  is  the 
smallest  subdivision  of  the  aerodynamic  component  for  which  data  (e.g., 
pressures,  forces,  and  moments)  are  computed.  Structural  elements  are  either 
metric  elements,  which  connect  structural  node  points  (grids),  scalar  ele¬ 
ments,  which  connect  pairs  of  degrees  of  freedom  or  pairs  of  scalar  points,  or 
mass  elements.  Table  8  shows  the  list  of  aerodynamic  and  structural  elements 
in  ASTROS  for  which  element  output  exists.  The  following  subsections  document 
the  quantities  that  are  available  as  output  for  each  of  these  elements.  The 
structural  mass  elements  are  not  included  in  this  table  since  they  have  no 
element  response  quantities.  The  NASTRAN  User's  Manual  (Reference  2)  was  used 
as  a  major  resource  in  writing  this  section,  and  the  user  is  referred  to  it 
for  additional  information  on  the  structural  elements. 


93 


TABLE  8.  AERODYNAMIC  AND  STRUCTURAL  ELEMENTS  IN  ASTROS 


Structural  element  output  is  available  for  all  disciplines  that  result 
in  a  real  displacement  field.  This  includes  STATICS,  MODES,  TRANSIENT,  BLAST, 
and  SAERO  analyses.  Complex  displacement  fields  (from  FLUTTER  and  FREQUENCY 
analyses)  result  in  computation  of  the  selected  (complex)  element  response 
quantities,  but  their  formatted  print  is  not  yet  available  except  through 
executive  sequence  print  utilities  described  in  Subsection  7.4.  For  all 
disciplines  in  ASTROS,  the  solution  control  print  options  STRESS,  STRAIN, 
FORCE,  and  ENERGY  are  used  to  select  print  of  the  structural  element  quanti¬ 
ties  and  the  PRESSURE  option  is  used  for  aerodynamic  element  quantities.  Each 
of  these  print  options  selects  either  ALL,  NONE  or  an  integer  set  identifica¬ 
tion  number  that  refers  to  one  or  more  ELEMLIST  bulk  data  entries  specifying 
which  elements  are  to  have  output  computed  and  printed.  Appendix  D  contains 
the  complete  description  of  the  solution  control  print  command.  Each  output 
is  carefully  labeled  as  to  its  boundary  condition  number,  discipline  generat¬ 
ing  the  response  field  and  load  condition,  mode  number,  time  step,  frequency 
step  or  flight  condition  represented  by  the  output. 

7. 2. 1.1  Aerodynamic  Element  Output 

Although  there  is  a  solution  control  print  request  for  pressures  at 
aerodynamic  boxes,  this  feature  has  not  been  fully  implemented.  Instead,  the 
aerodynamic  response  quantities  for  aerodynamic  elements  are  selectable 
through  modifications  to  the  print  arguments  of  the  PFAERO  and  AMP  modules 
(see  Subsection  7.3). 

7. 2. 1.2  Bar  Element  Output 

The  BAR  element  includes  extension,  torsion,  bending  in  two  perpendic¬ 
ular  planes  and  the  associated  shears.  The  shear  center  is  assumed  to  coin¬ 
cide  with  the  elastic  axis.  The  BAR  element  coordinate  system  is  shown  in 
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Figure  6.  The  orientation  of  the  BAR  element  is  described  in  terms  of  two 
reference  planes  defined  through  the  use  of  the  orientation  vector,  (v)  as 
shown  in  that  figure.  The  positive  directions  for  the  element  forces  are 
shown  in  Figure  7.  Additional  information  on  the  structural  elements  is 
contained  in  Section  5  of  the  ASTROS  Theoretical  Manual. 

Stresses,  strains,  forces  and  strain  energies  are  available  as  output 
for  the  BAR  element  through  the  STRESS,  STRAIN,  FORCE,  and  ENERGY  solution 
control  print  options.  The  following  element  forces  are  output  on  request: 

(1)  Bending  moments  at  each  end  in  both  reference  planes. 

(2)  Shear  forces  in  each  reference  plane. 

(3)  Average  axial  force. 

(4)  Torque  about  the  bar  axis. 

The  following  element  stresses  and  strains  in  the  element  coordinate  system 
are  output  on  request: 

(1)  Average  axial  stress  or  strain. 

(2)  Extensional  stress  or  strain  due  to  bending  at  four  points  on  the 
cross-section  at  each  end. 

(3)  Maximum  and  minimum  stress  or  strain  at  each  end. 

(4)  Stress  margins  of  safety  for  the  element  in  both  tension  and 
compression. 

Tensile  stresses  and  strains  are  given  a  positive  value  while  compressive 
stresses  and  strains  are  given  a  negative  value.  Unlike  similar  output  in 
NASTRAN,  the  bending  contribution  to  the  stresses  are  always  computed  at  the 
four  points  on  the  element  cross-section  that  were  specified  on  the 
connectivity  entry  for  the  BAR  element.  This  means  that  the  safety  margins 
are  computed  using  all  eight  stress  values  even  if  all  four  stress  points  at 
each  end  are  the  same  and/or  coincide  with  the  element  axis.  Also,  margins  of 
safety  are  printed  even  if  no  stress  limits  were  given  on  the  material  entry. 
In  these  cases,  a  very  large  value  foi  the  margin  of  safety  is  used  to  indi¬ 
cate  that  no  limits  were  specified.  In  addition,  ASTROS,  unlike  NASTRAN, 
fully  supports  strain  output  for  the  BAR  element.  Strain  energies  may  also  be 
requested  for  the  BAR  element.  The  strain  energy  print  (which  is  identical 
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Figure  6.  BAR  Element  Coordinate  System. 


Figure  7.  BAR  Element  Forces  Sign  Conventions. 


for  all  ASTROS  structural  elements)  is  patterned  after  that  in  NASTRAN.  It 
shows  the  total  strain  energy  for  the  given  displacement  field,  the  strain 
energy  in  each  selected  element  and  the  total  strain  energy  for  all  the 
elements  of  a  given  type,  e.g.,  all  the  BAR  elements. 

7. 2. 1.3  ELAS  Element  Output 

The  ELAS  element  is  a  scalar  spring  element  which  relates  the 
displacements  at  a  pair  of  scalar  points  or  degrees  of  freedom  or  that  relates 
a  single  degree  of  freedom  to  a  ground  state.  The  element  force  and  strain 
energy  are  directly  available  for  the  element  and  the  user  can,  if  desired, 
input  a  scalar  quantity  that  relates  the  "stress"  in  the  element  to  the 
displacement(s)  of  the  connected  degree (s)  of  freedom.  On  output,  these 
values  will  be  printed  for  each  output  request  for  each  selected  ELAS  element. 
Strains  have  no  meaning  for  the  scalar  spring  element  and  any  such  requests 
will  be  ignored  without  warning.  Element  strain  energies,  however,  are 
available  for  the  element  and  are  computed  from  the  spring  constant  and  the 
nodal  displacement(s) .  The  strain  energy  print  for  the  ELAS  is  identical  to 
that  for  the  BAR  element  and  includes  a  breakdown  by  element  and  by  element 
type .  If  no  scalar  value  is  given  for  the  element  stress  but  the  stress  value 
is  requested,  a  value  of  zero  will  be  computed  and  printed  for  the  response 
quantity  with  no  warnings  given. 

7. 2. 1.4  IHEX1  Element  Output 

The  IHEX1  element  is  a  linear  isoparametric  solid  hexahedron  element 
with  three  extensional  degrees  of  freedom  for  each  of  its  eight  nodes. 

Stresses,  strains,  and  strain  energies  are  available  as  output  for  the 
IHEX1  element  through  the  STRESS,  STRAIN,  and  ENERGY  solution  control  print 
command  options.  Force  output  is  not  available  for  the  IHEX1  element.  On 
request,  the  following  stresses  and  strains  are  output  in  the  basic  coordinate 
system  at  the  center  and  at  each  corner  grid  point: 

(1)  Normal  stresses  or  strains  in  all  three  directions. 

(2)  Shear  stresses  or  strains  in  all  three  planes. 

(3)  Principal  stresses  or  strains  in  all  three  directions  with 
associated  direction  cosines. 

(4)  Mean  stress  or  strain. 

(5)  Octahedral  shear  stress  or  strain. 
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The  stress  and  strain  output  at  each  of  the  nine  points  is  identified  by  a 
stress  or  strain  point  ID.  The  stress  and  strain  point  IDs  are  numbered  1 
through  9,  with  the  first  eight  ordered  as  on  the  associated  CIHEX1  input  data 
entry,  and  the  ninth  located  at  the  element  center,  as  illustrated  in  Figure 
8.  All  output  is  provided  in  the  basic  coordinate  system,  since  there  is  no 
naturally  occurring  element  coordinate  system  for  the  IHEX1. 

Strain  energy  output  may  be  requested  for  the  IHEX1  element.  The 
strain  energy  print  for  the  IHEX1  is  identical  to  that  for  the  BAR  element  and 
includes  a  breakdown  by  element  and  by  element  type. 

7. 2. 1.5  IHEX2  Element  Output 

The  IHEX2  element  is  a  quadratic  isoparametric  solid  hexahedron 
element  with  three  extensional  degrees  of  freedom  for  each  of  its  20  nodes. 

Stresses,  strains,  and  strain  energies  are  available  as  output  for  the 
IHEX2  element  through  the  STRESS,  STRAIN,  and  ENERGY  solution  control  print 
command  options.  Force  output  is  not  available  for  the  IHEX2  element.  On 
request,  the  following  stresses  and  strains  are  output  in  the  basic  coordinate 
system  at  the  21  points  located  at  the  center,  corners,  and  mid-edges  of  the 
element: 

(1)  Normal  stresses  or  strains  in  all  three  directions. 

(2)  Shear  stresses  or  strains  in  all  three  planes. 

(3)  Principal  stresses  or  strains  in  all  three  directions  with 
associated  direction  cosines. 

(4)  Mean  stress  or  strain. 

(5)  Octahedral  shear  stress  or  strair,. 


The  stress  and  strain  output  at  each  of  the  21  points  is  identified  by  a 
stress  or  strain  point  ID.  The  stress  and  strain  point  IDs  a^e  numbered  1 
through  21,  with  the  first  20  ordered  as  on  the  associated  CIHEX2  input  data 
entry,  and  the  21st  located  at  the  element  center.  Although  the  corner  stress 
and  strain  points  are  located  at  the  corner  grid  points  of  the  element,  the 
raid-edge  stress  and  strain  points  may  or  may  not  be  located  at  the  mid-edge 
grid  points,  depending  on  the  location  of  those  grid  points.  The 
stress/strain  points  for  the  IHEX2  are  illustrated  in  Figure  9.  All  output  is 
provided  in  the  basic  coordinate  system,  since  there  is  no  naturally  occurring 
element  coordinate  system  for  the  IHEX2 . 


(a)  ELEMENT  GRID  POINTS 


(b)  ELEMENT  STRESS  POINTS 


Figure  8.  IHEX1  Element. 


(a)  ELEMENT  GRID  POINTS 


(b)  ELEMENT  STRESS  POINTS 


Figure  9.  IHEX2  Element. 


Strain  energy  output  may  be  requested  for  the  IHEX2  element.  The 
strain  energy  print  for  the  IHEX2  is  identical  to  that  for  the  BAR  element  and 
includes  a  breakdown  by  element  and  by  element  type. 

7. 2. 1.6  IHEX3  Element  Output 

The  IHEX3  element  is  a  cubic  isoparametric  solid  hexahedron  element 
with  three  extensional  degrees  of  freedom  for  each  of  its  32  nodes. 

Stresses,  strains,  and  strain  energies  are  available  as  output  for  the 
IHEX3  element  through  the  STRESS,  STRAIN,  and  ENERGY  solution  control  print 
command  options.  Force  output  is  not  available  for  the  IHEX3  element.  On 
request,  the  following  stresses  and  strains  are  output  in  the  basic  coordinate 
system  at  the  21  points  located  at  the  center,  corners,  and  mid-edges  of  the 
element: 

(1)  Normal  stresses  or  strains  in  all  three  directions. 

(2)  Shear  stresses  or  strains  in  all  three  planes. 

(3)  Principal  stresses  or  strains  in  all  three  directions  with 
associated  direction  cosines. 

(4)  Mean  stress  or  strain. 

(5)  Octahedral  shear  stress  or  strain. 

The  stress  and  strain  output  at  each  of  the  21  points  is  identified  by  a 
stress  or  strain  point  ID.  The  stress  and  strain  point  IDs  are  numbered  1 
through  21.  Th  first  20  points  are  ordered  as  on  the  associated  CIHEX3  input 
data  entry,  except  that  there  is  only  one  mid- edge  point  per  edge,  instead  of 
two,  and  the  21st  point  is  located  at  the  element  center.  Although  the  corner 
stress  and  strain  points  are  located  at  the  corner  grid  points  of  the  element, 
the  mid-edge  stress  and  strain  points  may  or  may  not  be  located  at  a  grid 
point,  depending  on  the  location  of  the  mid- edge  grid  points.  The 
stress/strain  points  for  the  IHEX3  are  illustrated  in  Figure  10.  All  output 
is  provided  in  the  basic  coordinate  system,  since  there  is  no  naturally 
occurring  element  coordinate  system  for  the  IHEX3. 

Strain  energy  output  may  be  requested  for  the  IHEX3  element.  The 
strain  energy  print  for  the  IHEX3  is  identical  to  that  for  the  BAR  element  and 
includes  a  breakdown  by  element  and  by  element  type. 
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(a)  ELEMENT  GRID  POINTS  (b)  ELEMENT  STRESS  POINTS 

Figure  10.  IHEX3  Element 
7. 2. 1.7  Rod  Element  Output 

The  ASTROS  ROD  element  supports  both  extensions  I  and  rotational 
properties.  The  element  coordinate  system  and  sign  conventions  are  shown  in 
Figure  11.  ASTROS  supports  stress,  strain,  force  and  strain  energy  output  for 
the  ROD.  The  forces  that  are  computed  are: 

(1)  Axial  force. 

(2)  Torque  about  the  element  axis. 

The  torque  and  force  are  both  computed  even  if  the  particular  element  does  not 
support  torsional  or  extensional  forces,  respectively.  In  these  cases,  a 
value  of  zero  will  be  printed  for.  the  appropriate  response  quantity.  The 
stresses  and/or  strains  that  are  available  are: 

(1)  Axial  stress  or  strain. 

(2)  Torsional  stress  or  strain. 

(3)  Margin  of  safety  for  axial  stress. 

(4)  Margin  of  safety  for  torsional  stress. 


101 


X 


Figure  11.  ROD  Element  Coordinate  System 

The  margins  of  safety  for  strain  are  not  available  and  the  stress  margins  are 
computed  even  if  there  are  no  limits  specified  on  the  material  property  entry. 
In  these  cases,  a  large  safety  margin  value  is  used  to  signify  that  no  limits 
were  imposed.  The  strain  energy  print  for  the  ROD  is  identical  to  that  for 
the  BAR  element  and  includes  a  breakdown  by  element  and  by  element  type. 

7. 2. 1.8  QDMEM1  Element  Output 

The  QDMEM1  isoparametric,  quadrilateral,  membrane  element  supports 
isotropic,  orthotropic  and  composite  membrane  properties.  If  the  element  is 
composite,  the  individual  layers  are  treated  as  independent,  stacked  elements 
in  which  each  "layer,"  as  defined  on  the  PCOMP  bulk  data  entry,  represents  an 
element.  In  the  case  of  composite  elements,  the  layers  are  numbered  sequen¬ 
tially  starting  with  the  first  layer  appearing  on  the  PCOMP  entry.  Non¬ 
composite  elements  show  a  layer  number  of  zero. 

Stresses,  strains,  forces  and  strain  energies  are  available  for  each 
element  or  layer  of  a  composite  element.  Since  the  stresses,  strains,  and 
forces  vary  within  a  CQDMEM1  element,  the  intersection  point  of  the  diagonals 
projected  onto  the  mean  plane  of  a  warped  element  has  been  chosen  as  the  point 
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at  which  the  stresses,  strains,  forces  and  strain  energies  for  the  element  are 
computed.  The  stresses,  strains  and  element  forces  are  computed  in  the 
element  coordinate  system.  Figure  12  shows  the  element  coordinate  system  and 
the  stress  computation  point  for  the  QDMEM1  element. 

ASTROS  computes  the  running  loads  associated  with  the  stresses  for  the 
QDMEM1  element.  These  forces  are: 

(1)  The  force  components  in  the  element  coordinate  system  at  the 
stress  computation  point. 

The  QDMEM1  stress  and  strain  print  includes  the  following: 

(1)  The  normal  stresses  or  strains  at  the  stress  point  in  the  element 
x-  and  y-directions . 

(2)  The  shear  stress  or  strain  on  the  element  x  face  in  the  element 
y-direction. 

(3)  The  angle  in  degrees  between  the  element  x-axis  and  the  major 
principal  axis. 

(4)  The  major  and  minor  principal  (zero  shear)  stresses  or  strains. 

(5)  The  maximum  shear  stress  or  strain. 

The  strain  energy  print  for  the  QDMEM1  is  identical  to  that  for  the  BAR 
element  and  includes  a  breakdown  by  element  and  by  element  type. 

7. 2. 1.9  0UAD4  Element  Output 

The  QUAD4  isoparametric  quadrilateral  plate  element  includes  both 
membrane  and  bending  behavior.  Transverse  shear  flexibility  may  be  requested, 
as  can  the  coupling  of  membrane  and  bending  behavior.  The  QUAD4  element 
coordinate  system  and  node  numbering  are  shown  in  Figure  13.  The  QUAD4 
element  may  be  assigned  general  anisotropic  or  composite  material  properties. 
For  designed  composites,  the  layers  are  treated  as  stacked  membrane  elements 
similar  to  the  QDMEM1  element.  In  this  case,  the  layers  are  identified  by 
number  in  the  order  specified  on  the  PCOMP,  PC0MP1  or  PC0MP2  entry.  For 
design  invariant  composite  laminates,  the  output  always  refers  to  the  aggre¬ 
gate  laminate  properties  and  refers  to  layer  number  zero.  The  reference  plane 
of  the  QUAD4  element  may  be  offset  from  the  plane  of  the  grid  points  and 
variation  in  the  element  thickness  may  be  modeled  by  assigning  different 
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element  thicknesses  at  each  of  the  grid  points.  The  reader  is  referred  to 
Appendix  A  of  the  ASTROS  Theoretical  Manual  for  additional  information  on  the 
QUAD4  element. 

Stresses,  strains,  forces,  and  strain  energies  are  available  as  output 
for  the  QUAD4  element  through  the  STRESS,  STRAIN,  FORCE  and  ENERGY  solution 
control  print  command  options.  The  following  element  stresses  and  strains  are 
output  on  request: 

(1)  Combined  extensional  and  bending  stresses  and  strains  computed  at 
the  element  center  in  the  element  coordinate  system. 

(2)  Principal  stresses  and  strains  computed  at  the  element  center, 
including  the  angle  between  the  element  x-axis  and  the  principal 
axis . 

The  following  forces  are  output  on  request: 

(1)  Element  forces  computed  at  the  center  of  the  element  in  the  mean 
plane  in  the  element  coordinate  system. 

For  composite  materials,  all  output  quantities  are  computed  using  the  aggre¬ 
gate  laminate  properties.  Hence,  output  of  stresses  or  strains  at  the  ply  or 
laminae  level  is  currently  not  an  available  print  option  for  the  QUAD4  element 
in  ASTROS. 

7.2.1.10  Shear  Panel  Output 

The  shear  panel  is  an  element  which  resists  the  action  of  tangential 
forces  applied  to  its  edges.  In  ASTROS,  the  shear  panel  supports  only  iso¬ 
tropic  material  properties  and  makes  use  of  the  shear  flow  distribution 
approximation  of  Garvey  (Reference  4)  with  special  handling  for  warped, 
parallel  edge  and  general  trapezoidal  geometries.  The  element  coordinate 
system  and  sign  convention  are  shown  in  Figure  14.  The  stresses,  strains, 
forces  and  strain  energies  are  available  for  the  shear  panel.  The  element 
forces  that  are  computed  include  the  following: 

(1)  The  eight  forces  between  each  pair  of  nodes;  each  force  is 
directed  along  the  line  connecting  the  adjacent  nodes  (the 
element  edge) . 

(2)  The  four  "kick"  forces  at  each  node,  normal  to  the  plane  formed 
by  the  two  adjacent  element  edges. 

(3)  The  shear  flows  (forces/unit  length)  along  each  edge. 
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When  stresses  or  strains  are  requested,  they  are  computed  at  the  node  points 
in  skewed  coordinates  parallel  to  the  adjacent  edges.  Both  the  average  and 
maximum  shear  stress  or  strain  are  then  printed.  A  safety  margin  based  on  the 
maximum  stress  value  is  computed  for  stress  output.  A  large  safety  margin  is 
printed  if  no  limits  were  specified  on  the  material  property  entry. 

The  strain  energy  print  for  the  SHEAR  panel  is  identical  to  that  for 
the  BAR  element  and  includes  a  breakdown  by  element  and  by  element  type. 


Figure  14.  Shear  Panel  Forces  and  Element  Coordinate  System. 


7.2.1.11  TRMEM  Element  Output 

The  TRMEM  constant  strain  triangular  membrane  element  supports  iso¬ 
tropic,  orthotropic  and  composite  membrane  properties.  If  the  element  is 
composite,  the  individual  layers  are  treated  as  independent,  stacked  elements 
in  which  each  "layer,"  as  defined  on  the  PCOMP  bulk  data  entry,  represents  an 
element.  The  layers  are  numbered  sequentially  starting  with  the  first  layer 
appearing  on  the  PCOMP  entry.  Non- composite  elements  will  use  a  layer  number 
of  zero. 

Stresses,  strains,  forces  and  strain  energies  are  available  for  each 
element  or  layer  of  a  composite  element.  The  invariant  stresses,  strains  and 
forces  within  a  TRMEM  element  are  computed  in  the  element  coordinate  system 
shown  in  Figure  15. 
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ASTROS  computes  the  running  loads  associated  with  the  stresses  for  the 
TRMEM  element.  These  forces  are: 

(1)  The  force  components  in  the  element  coordinate  system. 

The  TRMEM  stress  and  strain  print  includes  the  following: 

(1)  The  normal  stresses  or  strains  in  the  element  x-  and  y-direc- 
tions . 

(2)  The  shear  stress  or  strain  on  the  element  x  face  in  the  element 
y-direction. 

(3)  The  angle  in  degrees  between  the  element  x-axis  and  the  major 
principal  axis. 

(4)  The  major  and  minor  principal  (zero  shear)  stresses  or  strains. 

(5)  The  maximum  shear  stress  or  strain. 

The  strain  energy  print  for  the  TRMEM  is  identical  to  that  for  the  BAR  element 
and  includes  a  breakdown  by  element  and  by  element  type. 
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7.2.2  Nodal  Response  Quantities 

ASTROS  has  two  basic  forms  of  node  points:  the  structural  node  and 
the  extra  point.  The  structural  node  is  defined  as  either  a  "grid"  point 
having  six  degrees  of  rreedom  (three  translations  and  three  rotations)  or  a 


"scalar"  point  having  a  single  degree  of  freedom.  These  node  points  can  be 
used  to  connect  metric  and  scalar  structural  elements.  The  extra  point  is 
similar  to  the  scalar  point  in  that  it  has  a  single  degree  of  freedom,  but 
differs  in  that  extra  points  included  in  the  model  are  selected  in  the  bounda¬ 
ry  condition  rather  than  being  implicitly  included  in  the  model.  Further, 
they  cannot  be  connected  directly  to  either  metric  or  scalar  structural 
elements;  instead,  these  elements  are  connected  through  terms  introduced  by 
direct  matrix  input  or  by  transfer  functions.  Extra  points  are  used  in 
dynamic  analyses  for  modeling  control  systems  and  other  non-structural  mecha¬ 
nisms  in  the  system  under  analysis.  These  degrees  of  freedom  do  not  appear  in 
the  system  matrices  until  after  the  dynamic  matrix  assembly  and  do  not  appear 
in  any  but  the  dynamic  response  disciplines  (FLUTTER,  TRANSIENT,  FREQUENCY  and 
BLAST).  When  nodal  output  is  requested  for  dynamic  analyses,  any  extra  point 
results  may  be  selected  using  the  GRIDLIST  entry  just  as  are  grid  and  scalar 
point  results. 

Nodal  output  is  available  for  all  disciplines  in  ASTROS,  although 
particular  nodal  response  quantities  may  not  be  available  for  all  disciplines. 
The  solution  control  print  options  VELOCITY,  DISPLACEMENT,  GPFORCE,  LOAD, 
SPCFORCE,  and  ACCELERATION  are  used  to  select  print  of  the  nodal  response 
quantities.  Each  of  these  print  options  selects  either  ALL,  NONE  or  an 
integer  set  identification  number  that  refers  to  one  or  more  GRIDLIST  bulk 
data  entries.  Appendix  D  contains  the  complete  description  of  the  solution 
control  print  command.  Each  output  is  carefully  labeled  as  to  its  boundary 
condition  number,  which  discipline  generated  the  output  quantities  and  which 
load  condition,  mode  shape,  time  step,  frequency  step  or  flight  condition  is 
represented  by  the  output. 

The  form  of  nodal  output  in  ASTROS  is  very  similar  for  all  nodal 
output  quantities;  therefore,  only  general  descriptions  will  be  given  rather 
than  Individually  describing  each  response  quantity  in  turn.  The  nodal  output 
includes  the  node  point  identification  number  (sorted  by  external  identifica¬ 
tion  number)  and  node  type:  (G)rid,  (S)calar  point  or  (E)xtra  point.  This  is 
followed  by  either  one  or  six  quantities  associated  with  the  node  point.  The 
columns  of  the  print  are  labeled  Ti  for  the  translations  and  Ri  for  the 
rotation  where  i  -  1,  2  or  3.  Complex  nodal  quantities  are  generated  by 
FLUTTER  and  FREQUENCY  disciplines  and  can  be  printed  in  either  polar 
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coordinates  or  Cartesian  coordinates  through  the  form  option  on  the  PRINT  or 
PUNCH  command.  Cartesian  print  is  the  default.  Complex  quantities  are 
printed  using  the  same  columns  as  real  nodal  data  but  use  two  lines  of  output. 
The  first  line  contains  either  the  real  part  or  the  magnitude  and  the  second 
line  either  the  imaginary  part  or  the  phase  angle  in  degrees. 

All  disciplines  generate  DISPLACEMENT  output  except  some  FLUTTER  and 
SAERO  analyses.  Flutter  mode  shapes  are  generated  only  if  a  flutter  condition 
occurs  in  the  selected  range  of  velocities  and  then  only  if  the  FLUTTER 
discipline  occurs  in  the  ANALYZE  subpacket  of  the  solution  control.  Steady 
aeroelastic  analyses  which  do  not  perform  a  trim  analysis  also  do  not  generate 
displacement  vectors.  Velocities  and  accelerations  are  only  available  for 
TRANSIENT,  BLAST  and  FREQUENCY  analyses. 

The  LOAD  option  selects  output  of  externally  applied  loads  at  the 
nodal  points.  For  STATICS,  the  applied  mechanical,  thermal  and/or  gravity 
loads  are  output  for  the  selected  nodes  and  subcases.  Steady  aeroelastic 
loads  output  writes,  for  each  trim  condition,  those  trimmed  forces  applied  to 
the  structure  following  transformation  from  the  aerodynamic  model.  No  loads 
output  is  available  if  no  trim  is  performed  in  the  aeroelastic  analysis. 
TRANSIENT,  FREQUENCY  and  BLAST  disciplines  compute  loads  at  user  specified 
time  or  frequency  steps  which  may  be  printed.  The  FLUTTER  discipline  has  no 
loads  output. 

The  SPCFORCE  print  of  single  point  forces  of  constraint  has  not  been 
fully  implemented  and  so  is  not  available,  although  the  solution  control 
command  is  functional.  The  GPFORCE  grid  point  force  balance  is  similarly  not 
completely  installed.  All  the  quantities  needed  to  print  a  grid  point  force 
balance  similar  to  that  in  MSC/NASTRAN  are  available  on  the  data  base  but  the 
final  print  modules  have  not  been  implemented.  In  both  cases,  these  selec¬ 
tions,  if  they  appear  in  the  solution  control  packet,  will  be  ignored  without 
warning. 

7.2.3  Design  Variables  and  Design  Constraints 

There  is  an  important  distinction  between  global  design  variables  and 
local  design  variables  in  ASTROS.  A  number  of  linking  options  relating  global 
variables  to  local  variables  are  provided  and  are  described  in  Section  2  of 
the  Theoretical  Manual.  Briefly,  the  local  variable  is  the  physical  element 


property  (e.g.,  thickness  or  cross* sectional  area)  that  is  free  to  change  in 
the  design  process  while  the  global  variables  are  the  actual  variables  that 
are  aodified  by  the  resizing  module.  The  resultant  physical  variables  are 
then  computed  based  on  the  user's  linking  options  and  the  current  global 
design  variable  values. 

The  DESIGN  solution  control  print  option  allows  the  user  to  request 
that  the  global  and  local  design  variables  be  printed  at  each  iteration.  As 
discussed  in  Subsection  7.1,  this  print  is  the  default  on  the  last  iteration. 
The  global  variable  print  displays  the  user  assigned  design  variable  identifi¬ 
cation  number,  the  current  value,  the  minimum  and  maximum  values  allowed  for 
the  global  variable,  the  sensitivity  of  the  objective  function  to  the  design 
variable  and  the  linking  option  used  to  relate  it  to  local  design  variables. 
The  linking  options  are: 

(1)  Unique  Physical.  The  user  has  related  the  global  variable  to  a 
single  local  variable  through  a  DESELM  entry. 

(2)  Linked  Physical.  The  user  has  related  the  global  variable  to 
some  number  of  local  variables  through  a  combination  of  DESVAR/ 
PLIST  entries. 

(3)  Shape  Function.  The  user  has  related  this  and  possibly  other 
global  variables  to  some  number  of  local  variables  through  a 
combination  of  DESVAR/ELIST  entries. 

The  final  item  in  the  global  design  variable  print  is  an  eight -character  user 
label  identifying  the  design  variable. 

The  local  design  variables  are,  of  course,  element  dependent.  Each 
element  type  that  has  elements  connected  to  global  design  variables  is  printed 
separately.  The  elements  are  identified  by  element  identification  number  and, 
if  appropriate,  the  layer  number.  The  linking  option  used  to  connect  them  to 
the  global  variables  is  also  shown.  This  print  can  be  very  helpful  in  check¬ 
ing  the  correctness  of  the  design  model.  Following  these  general  data  are  the 
element  dependent  local  variable  value  and  the  allowable  range  that  the 
primary  value  can  take.  Note  that  the  BAR  element  links  the  moments  of 
inertia  to  the  cross-sectional  area  so  all  three  "design  variables"  are  shown 
but  the  area  is  the  only  independent  variable.  The  local  variable  print 
accounts  for  all  scalar  factors  that  might  appear  in  the  design  variable 
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linking  and  therefore,  indicates  the  true  physical  values  represented  by  the 
current  design.  Finally,  the  two-dimensional  elements  include  a  print  of  the 
ratio  of  the  current  thickness  to  the  minimum  thickness.  This  additional  item 
is  included  as  a  convenience  to  allow  a  quick  computation  of  the  number  of 
composite  plys  represented  by  a  particular  design  IF  the  user  inputs  the  ply 
thickness  as  the  minimum  thickness  and  IF  the  element  has  composite  material 
properties . 

The  solution  control  print  option  DCONSTRAINT  selects  that  the  active 
constraint  summary  print  should  include  a  table  indicating  which  constraints 
are  active,  their  current  value,  the  constraint  type  and  other  identifying 
data  connecting  the  constraints  to  a  particular  element,  subcase  and/or 
discipline.  These  extra  data  include  the  "type  count,"  which  is  a  running 
count  (by  constraint  type)  of  all  active  and  inactive  constraints.  This 
allows  the  user  to  identify  exactly  which  constraint  is  active;  e.g.,  the 
fourth  flutter  constraint  or  the  3000th  von  Mises  stress  constraint.  Addi¬ 
tionally,  if  the  constraint  is  associated  with  a  particular  boundary  condi¬ 
tion,  the  associated  boundary  condition  identification  is  shown.  Similar 
connections  are  made  for  subcase  and  element  dependent  constraints.  If  the 
constraint  is  not  boundary  condition,  subcase  or  element  dependent,  zeros  or 
blanks  will  appear  in  the  corresponding  columns  of  the  active  constraint 
summary.  The  user  is  cautioned  that  the  constraint  ordering  in  the  active 
constraint  summary  is  not  necessarily  the  order  that  constraints  appear  in  the 
sensitivity  matrices,  the  DESIGN  module  or  other  discipline  dependent  output. 

Finally,  in  interpreting  the  constraint  values,  the  user  must  be  aware 
of  some  features  of  ASTROS  design  constraints.  The  constraints  in  ASTROS  are 
all  formulated  such  that  a  value  greater  than  zero  represents  a  violated 
constraint.  Also,  all  the  constraints  are  normalized  in  some  manner  by  the 
design  allowable.  The  normalization  has  been  formulated  in  such  a  way  as  to 
provide  the  best  behavior  under  the  linear  approximations  used  in  the  approxi¬ 
mate  optimization  problem  but  this  has  the  effect  of  obscuring  the  physical 
meaning  of  the  constraint.  The  user  is  referred  to  the  Theoretical  Manual  for 
the  exact  form  of  each  constraint. 

7.2.4  Flutter/Normal  Modes  Response  Quantities 


The  solution  control  print  option  ROOTS  selects  that  the  root  extrac¬ 
tion  summary  for  flutter  analyses  be  printed.  In  addition,  if  the  flutter 


analyses  appear  in  the  ANALYZE  subpacket  of  the  solution  control  packet,  the 
modal  participation  factors  of  any  flutter  conditions  will  be  printed.  The 
roots  are  ordered  such  that  the  lowest  frequency  root  at  each  velocity  is 
associated  with  the  lowest  frequency  normal  mode  and  so  on  in  increasing 
frequency  order.  For  each  normal  mode,  the  corresponding  velocity  value, 
damping  ratio,  frequency  and  complex  eigenvalue  are  shown.  For  OPTIMIZE 
flutter  analyses,  only  the  user's  input  velocities  are  used  in  the  root 
extraction  algorithm.  ANALYZE  flutter  analyses  may  generate  additional 
velocities  in  the  process  of  converging  to  a  flutter  crossing. 

The  complex  modal  participation  factors  for  each  of  the  normal  modes 
in  the  modal  representation  of  the  structure  are  printed  if  the  ROOTS  option 
is  selected  in  ANALYZE  flutter  disciplines  and  a  flutter  condition  is  found. 
A  flutter  condition  can  occur  for  each  Mach  number  and  density  ratio  combina¬ 
tion  in  the  flutter  analysis.  Therefore,  the  flutter  condition  is  identified 
by  velocity,  Mach  number  and  density  ratio  to  distinguish  among  multiple 
flutter  conditions  in  the  same  analysis.  Note  that  a  zero  participation 
factor  is  shown  for  normal  modes  that  the  user  omitted  from  the  flutter 
analysis . 

The  ROOTS  print  option  for  normal  modes  selects  that  the  eigenvalue 
extraction  table  be  printed.  It  appears  immediately  ahead  of  any 
eigenvectors,  if  any  were  selected.  The  table  is  patterned  after  that  in 
MSC/NASTRAN  and  includes  the  eigenvalues  (in  sorted  order),  the  extraction 
order,  the  cyclic  and  radian  frequency  and  generalized  mass  and  generalized 
stiffness  for  each  eigenvalue  extracted.  The  table  is  prefaced  by  data 
identifying  the  eigenvalue  extraction  method  and  some  self-explanatory  method 
dependent  data. 

7.2.5  AeKpeJftstlg  Trim  Quantities 

The  TRIM  solution  control  print  option  selects  that  the  aeroelastic 
trim  parameters  and  stability  coefficients  be  printed.  There  are  three  types 
of  aeroelastic  trim  analyses  in  ASTROS:  (1)  the  zero  degree  of  freedom  trim 
(or  no  trim);  (2)  the  single  degree  of  freedom  (lift)  longitudinal  trim;  and 
(3)  the  two  degrees  of  freedom  (lift  and  pitching  moment)  longitudinal  trim. 
The  zero  degree  of  freedom  "trim"  may  be  either  longitudinal  or  lateral.  Each 
TRIM  print  is  labeled  with  the  Mach  number,  dynamic  pressure,  reference  grid 
point,  and  the  appropriate  normalization  parameters.  These  parameters  are  the 
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reference  area  and  chord  length  for  longitudinal  coefficients  and  reference 
area  and  span  for  lateral  coefficients. 


'The  longitudinal  trim  print  includes,  in  the  most  general  case,  the 
lift  and  pitching  moment  stability  coefficients  for: 


CL  » 
o 

CM 

o 

' 

Thickness  and  camber  effects 

CL  .  CM 
a  a 

- 

Angle  of  attack  (a)  in  both  radians  and  degrees 

V  C"s 

- 

Elevator  deflection  (5)  in  both  radians  and 
degrees 

cL  . 

CM 

- 

Pitch  rate  (q)  in  both  radians  and  degrees. 

q  q 


These  nondimens ional  factors  are  implicitly  defir  d  in  the  following 
equations : 

Lift  - 


Pitching  Moment  - 


5  s  [°Lo  +  \  ■  ♦  Ch  *  +  ] 

i  Sc  [  C«o  +  “  +  CM«  °Hq  2V  ] 


where , 

q  -  Dynamic  Pressure 

S  -  Reference  Area 

c  -  Reference  Chord 

V  -  Reference  Velocity 

These  definitions  are  the  standard  forms  used  in  aircraft  stability  and 
control  (see  Reference  5) . 

Each  of  these  pairs  of  quantities  (lift  and  pitching  moment  coeffi¬ 
cients)  is  shown  in  three  forms: 

(1)  The  stability  derivative  for  the  rigid  aerodynamic  model  as 
computed  directly  from  the  forces  acting  on  the  aerodynamic  boxes 
(termed  DIRECT  in  the  output). 
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(2)  The  stability  derivative  for  the  rigid  aerodynamic  model  as 

computed  from  the  forces  transformed  to  the  structural  degrees  of 
freedom  (termed  SPLINED  in  the  output) . 

(3)  The  flexible  derivative  which  includes  corrections  for  the 

flexibility  and  inertia  relief  effects. 

If  the  first  two  forms  do  not  agree  closely  (within  1  to  2  percent)  ,  the 

spline  transformation  may  be  incorrect  and  the  first  step  to  correct  this 

would  be  to  check  the  SPLINE1  and  ATTACH  data  entries.  The  second  and  third 
forms  are  used  in  the  lift  effectiveness  calculations. 

Finally,  the  trim  parameters  that  were  computed  for  the  current  flight 
condition  are  shown.  In  general,  these  are  the  angle  of  attack  in  degrees  and 
the  elevator  deflection  angle  in  degrees.  For  single  degree  of  freedom  trim 
(i.e.,  lift  equals  weight),  the  elevator  stability  coefficients  and  trim 
parameter  will  not  appear  in  the  print. 

The  lateral  trim  print  is  onl}  applicable  to  zero  degree  of  freedom 
trim  analyses  in  which  the  SUPORT  degree  of  freedom  is  an  axial  roll  degree  of 
freedom.  In  this  case,  the  rolling  moment  stability  coefficients  associated 
with  the  following  quantities  are  shown: 


ch 

°a 

wm 

Rolling 

radians 

moment  due 
and  degrees . 

to  aileron  deflection  (6), 

in  both 

Cl 

P 

- 

Rolling 
degrees . 

moment  due 

to  roll  rate  (p) ,  in  both 

radians 

These  nondimens ional  factors  are  implicitly  defined  in  the  following 
equation: 

Roll  -  qSb  [  C 7  «a  +  Cj 

[  6a  P  2V  J 

where, 

b  -  reference  semispan 
These  quantities  are  shown  in  three  forms: 
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(1)  The  stability  derivative  for  the  rigid  aerodynamic  model  as 

computed  directly  from  the  forces  acting  on  the  aerodynamic  boxes 
(termed  DIRECT  in  the  output). 

(2)  The  stability  derivative  for  the  rigid  aerodynamic  model  as 

computed  from  the  forces  transformed  to  the  structural  degrees  of 
freedom  (termed  SPLINED  in  the  output). 

(3)  The  flexible  derivative  which  includes  corrections  for  the 

flexibility  and  inertia  relief  effects. 

As  in  the  longitudinal  case,  discrepancies  between  the  data  for  the  first  two 
forms  may  indicate  an  error  in  the  spline  transformations.  The  aileron 
effectiveness  calculation  is  performed  using  the  third  form.  There  are  no 
trim  parameters  printed  with  the  lateral  stability  coefficients. 

7.3  EXECUTIVE  SEQUENCE  SELECTABLE  QUANTITIES 

The  MAPOL  compiler  supports  a  feature  to  declare  that  certain  argu¬ 
ments  to  modules  (external  procedures  or  functions)  be  optional.  These  have 
been  used  in  several  ASTROS  modules  for  debug  print  requests.  A  number  of 
modules,  therefore,  have  "hidden"  arguments  which  do  not  appear  in  the  stan¬ 
dard  sequence,  but  which  may  be  included  if  a  nonzero  or  nonblank  value  (the 
defaults  for  optional  MAPOL  arguments  are  zero  or  blank,  as  appropriate)  is 
desired.  This  subsection  documents  the  optional  arguments  to  ASTROS  modules 
that  relate  to  modifying  the  level  or  form  of  output  from  the  module.  These 
options  are  also  presented  in  the  appropriate  Programmer's  Manual  sections. 

7.3.1  Bulk  Data  Echo  Options 

The  input  file  processor  module,  IFP,  has  the  two  optional  arguments, 
SORT  and  ECHO,  in  its  calling  sequence: 

CALL  IFP  (GSIZE ,  sort,  echo); 

Both  SORT  and  ECHO  are  integer  arguments  that  control  the  form  and  destination 
for  the  echo  of  the  bulk  data  packet.  The  following  options  are  available: 
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SfiEI 


ACTION 


E£HQ 


0 

0 

0 

0 

>0 

>0 

>0 

>0 


0  Sorted  echo  to  the  output  file. 

1  No  echo  to  either  output  or  punch  files. 

2  Sorted  echo  to  punch  file. 

>2  Sorted  echo  to  both  output  and  punch  files. 

0  Unsorted  echo  to  the  output  file. 

1  No  echo  to  either  output  or  punch  files. 

2  Unsorted  echo  to  punch  file. 

>2  Unsorted  echo  to  both  output  and  punch  files. 


The  default  is  that  sorted  echo  is  written  to  the  output  file  and  nothing  is 
written  to  the  punch  file. 


7.3.2  Intermediate  Steady  Aerodynamic  Matrix.  Output 

The  preface  aerodynamic  module,  PFAERO,  has  a  single  optional  integer  print 
debug  as  the  last  argument  of  it  calling  sequence: 


CALL  PFAERO  (GSIZE,  [ AICMAT(MINDEX) ] ,  ( AAICMAT(MINDEX) ] , 

(AIRFRC(MINDEX) ] ,  MINDEX,  NAERO,  [GTKG] ,  [GSTKG] ,  [ UGTKG ] , 
[AJJTL] ,  (D1JK] ,  [D2JK] ,  [SKJ],  print); 


The  PRINT  option  will  generate  output  from  the  USSAERO  submodule  of  the 
preface  aerodynamics  module  PFAERO.  There  are  five  print  levels  available: 


ESINT  ACTION 

0  No  printed  output  is  generated. 

1  Prints  steady  aerodynamic  model  geometry  and  a  few 
miscellaneous  debugs. 

2  Prints  the  above  and  stability  coefficient  data. 

3  Prints  the  above  and  pressure  data  from  the  USOLVE 
submodule . 

4  Prints  the  above  and  voluminous  data  from  the 
calculation  of  velocity  components  and  intermedi¬ 
ate  matrices  from  the  USSAERO  submodule. 


The  user  is  cautioned  that  a  print  level  of  4  generates  a  large  amount  of 
data.  Host  of  these  prints  are  vestigial  prints  from  the  USSAERO  code  that 
was  adapted  for  use  in  the  ASTROS  system.  In  cases  where  the  output  data  are 
not  self-evident,  the  user  is  referred  to  the  USSAERO  documentation  (Reference 
6). 
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/•JJ  intermediate  Unsteady  Aerodynamic  Matrix  Output 

The  secondary  unsteady  aerodynamic  preface  module,  AMP,  has  an  option¬ 
al  integer  print  argument  as  the  last  argument  in  its  calling  sequence  and  an 
optional  matrix  argument  as  the  second  to  last: 

CALL  AMP  ( [AJJTL]  ,  [D1JK] ,  [D2JK] ,  [SKJ],  [QKKL] ,  QKJL]  ,  [QJJL) , 

[ajjdc],  print); 

The  PRINT  option  controls  the  output  of  several  intermediate  matrices 
or  of  individual  matrices  from  the  matrix  lists  QKKL,  QKJL  and  QJJL  that  are 
formed  in  AMP  for  FLUTTER,  GUST  and  BLAST  analyses,  respectively.  The  user  is 
referred  to  the  Programmer's  Manual  for  complete  documentation  of  these  data 
base  entities.  The  following  matrices  are  output: 

PRINT  ACTION 

0  No  output. 

1  (1)  The  SKJ  matrix. 

If  there  is  only  one  aerodynamic  group,  the 
following  are  also  printed: 

(2)  If  FLUTTER  entries  are  in  the  bulk  data  packet, 
the  matrix,  [X] ,  representing  the  solution  to  the 
equation: 

[AJJ]  *  [X]  -  (  [ D1JK]  +  (ik) [D2JK]  ) 

(3)  If  GUST  entries  are  in  the  bulk  data  packet,  the 
matrix  [QKJ]  from  the  corresponding  matrix  list. 

(4)  If  BLAST  entries  are  in  the  bulk  data  packet,  the 
matrix  [QJJ]  from  the  corresponding  matrix  list. 

>1  All  of  the  above  and: 

(1)  If  FLUTTER  entries  are  in  the  bulk  data  packet, 
the  matrices  [D1JK]  and  [D2JK] . 

(2)  The  matrix  [AJJT]  after  extraction  from  the 
corresponding  matrix  list. 

The  optional  matrix  [AJJDC]  is  used  to  store  the  intermediate  matrix  [X] 
described  in  the  options  shown  above.  If  [AJJDC]  is  blank,  a  scratch  data 
base  entity  is  used  to  store  [X],  In  either  case,  [X]  may  be  printed  through 
the  PRINT  option.  Only  the  last  [X]  matrix  calculated  will  be  returned  to  the 
executive  sequence  in  [AJJDC]  for  use  in  additional  processing. 
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The  flutter  analysis  module,  FLUTTRAN,  has  an  optional  trailing 
integer  print  argument  to  generate  additional  information  on  the  flutter 
eigenvalue  extraction: 

CALL  FLUTTRAN  (BC,  (QHHL(BC) ) ,  LAMBDA,  HSIZE,  [MHH(BC) ] , 
(KHHF(BC) ] ,  print); 

The  PRINT  option  in  this  case  pertains  to  prints  that  give  information  on  the 
iterative  solution  of  the  flutter  matrices.  The  PRINT  option  has  the  follow¬ 
ing  meaning: 

PRINT  ACTION 

0  No  output . 

1  Print  the  number  of  iterations  required  to  find  each 

flutter  root. 

>1  Print  the  above  plus  information  on  each  of  the  esti¬ 

mated  roots  for  each  iteration.  This  voluminous 
information  may  sometimes  be  of  use,  when  the  flutter 
solution  goes  astray,  in  determining  if  a  modified  set 
of  velocities  would  give  improved  results. 

7.3.5  Stress  Constraint  Computation  Output 

The  stress/strain  constraint  evaluation  module,  SCEVAL,  has  an  option¬ 
al  integer  print  parameter  as  its  final  argument: 

CALL  SCEVAL  (  BC,  [GLBSIG],  (UG(BC) ] ,  TRMTYP,  print  ); 


The  PRINT  argument,  if  nonzero,  will  generate  a  listing,  by  element  type,  of 
all  the  constrained  elements,  the  current  value  of  their  stress  components  and 
the  resultant  constraint  value  for  each  design  load  condition.  Also  included 
in  the  print  is  the  running  "type  count"  for  stress  and  strain  constraints 
that  appear  in  the  Active  Constraint  Summary  print  described  in  Subsection 
7.2.3.  This  allows  the  user  to  identify  exactly  which  elements  and  subcases 
are  associated  with  each  particular  stress  or  strain  constraint.  This  print 
is  a  remnant  from  the  ASTROS  development  when  the  element  stresses  were  not 
available,  but  it  may  still  be  useful  in  checking  out  the  constraint  modeling 
for  large  problems. 


The  DESIGN  module  for  resizing  via  mathematical  programming  methods 
has  a  final  optional  integer  print  argument  that  selects  a  print  of  intermedi¬ 
ate  data: 

CALL  DESIGN  (CONVERGE,  MOVLIM,  CNVRGLIM ,  CTL,  CTLMIN,  OPSTRAT, 
NUMOPTBC ,  [AMAT],  print); 

The  PRINT  argument  is  passed  directly  to  the  MICRODOT  optimization  package 
which  makes  the  following  intermediate  quantities  available: 

PRINT  ACTION 

0  No  output  is  generated. 

1  Initial  design  information  and  final  results. 

2  The  above  and  function  values  at  each  iteration. 

3  The  above  and  internal  MicroDOT  parameters. 

4  The  above  and  search  directions. 

5  The  above  and  gradient  information. 

6  The  above  and  scaling  information. 

7  The  above  and  one -dimensional  search  information. 

These  PRINT  options  allow  the  user  to  view  the  detailed  calculations  used  in 
the  solution  of  the  approximate  constrained  optimization  problem  that  ASTROS 
generates  at  each  iteration.  The  user  is  cautioned  that  the  data  printed  from 
the  DESIGN  module  are  not  necessarily  ordered  in  the  same  manner  as  in  other 
design  prints  and  not  identified  by  user  supplied  design  variable  identifica¬ 
tion  numbers. 

7.4  EXECUTIVE  SEQUENCE  OUTPUT  UTILITIES 

In  recognition  of  the  inability  to  provide  for  the  print  of  all  useful 
response  quantities,  utilities  have  been  included  in  the  set  of  MAPOL  modules 
to  augment  the  solution  control  print  options.  These  utilities  may  be  placed 
in  any  MAPOL  program  where  the  user  desires  to  see  additional  information. 
These  utilities  print  the  data  contained  in  general  data  base  entities.  The 
formats  of  these  prints  are  more  general  and  therefore,  less  well  identified 
than  the  special  print  options  described  in  the  preceding  subsections.  The 
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generality  of  these  utilities,  however,  Is  felt  to  be  a  vital  addition  to  the 
output  features  of  the  ASTROS  procedure  In  that  almost  any  data  on  the  user's 
data  base  files  can  be  written  to  the  output  file.  These  utilities  provide  a 
priaitive  link  between  ASTROS  and  external  post-processing  systems. 

7.4.1  Structural  Set  Definition  Print  Utility,  USETPRT 

The  USETPRT  utility  has  been  provided  to  print,  for  each  boundary 
condition  In  the  solution  control  packet,  the  structural  set  definition  table 
stored  In  the  ASTROS  data  base  entity,  USET.  This  utility  exactly  mimics  the 
capabilities  provided  by  the  NASTRAN  PARAM/USETPRT  option.  The  USETPRT  module 
has  the  following  calling  sequence: 

CALL  USETPRT  (  BC  ) ; 

For  the  selected  boundary  condition,  BC,  each  degree  of  freedom  in  the  struc¬ 
tural  model  Is  listed  In  a  table  which  shows  the  structural  sets  to  which  the 
degree  of  freedom  belongs.  The  reader  is  referred  to  Section  4  of  the  Theo¬ 
retical  Manual  for  more  Information  on  the  structural  set  definitions  in 
ASTROS . 

7.4.2  Special  Matrix  Print  VtUitY^-VTCPRT 

The  print  utility  UTGPRT  has  been  provided  In  order  to  view  particu¬ 
lar  matrices  whose  rows  correspond  to  the  structural  degrees  of  freedom.  In 
general,  these  matrices  are  very  large  and  virtually  Impossible  to  interpret 
without  some  additional  formatting  beyond  that  which  Is  available  for  more 
general  matrix  prints.  Therefore,  for  the  supported  matrix  entitles,  the 
matrix  columns  are  printed  in  a  form  similar  to  that  used  for  the  nodal 
response  quantities  as  presented  in  Subsection  7.2.2.  The  UTGPRT  utility  has 
the  following  calling  sequence: 

CALL  UTGPRT  (  BC,  [matl] ,  [mat2],  ...  [raatlO]  ); 

where  up  to  ten  matrix  arguments  may  be  supplied.  The  BC  Integer  argument 
identifies  the  associated  boundary  condition  so  that  the  utility  can  make  use 
of  the  USET  entity  In  formatting  the  output.  The  following  entities  are 
supported: 
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[DRUG],  [DMUG] ,  [DPVJ] ,  [DUG],  [DPGV] ,  [DUGV] 

and 

[DPTHVI] ,  [DPGRVI ] 

and 

[PG] 

and 

[ DFDU ] 

The  utility  keys  off  the  entity  names,  so  the  above  names  must  be  used, 
although  the  matrices  can  be  subscripted  if  the  user  wishes.  The  reader  is 
referred  to  the  Programmer's  Manual  for  additional  information  on  the  data 
contained  in  these  entities. 

7.4.3  General  Matrix  Print  Utility.  UTMPRT 

The  matrix  print  utility  UTMPRT  has  been  written  such  that  any  data 
base  matrix  entity  can  be  printed  to  the  output  file.  The  calling  sequence 
for  UTMPRT  is: 

CALL  UTMPRT  (  method,  [matl],  [mat2] ,  ...  [matlO]  ); 

where  up  to  ten  matrices  can  be  printed  in  a  single  call.  The  optional 
integer  METHOD  argument  selects  from  among  two  formats  that  are  available.  If 
METHOD  is  zero  or  absent,  the  entire  matrix  column,  starting  with  the  first 
nonzero  term  and  ending  with  the  last  nonzero  term,  will  be  printed,  includ¬ 
ing  all  intermediate  zeros.  If  METHOD  is  nonzero,  only  the  nonzero  terms  of 
each  column  will  be  printed. 

7.4.4  General  Relation  Print  Utility.  UTRPRT 

The  print  utility  UTRPRT  has  been  written  such  that  any  data  base 
relational  entity  can  be  printed  to  the  output  file.  The  calling  sequence  for 
UTRPRT  is: 

CALL  UTRPRT  (  rell ,  rel2,  ...  rellO  ); 

where  up  to  ten  relations  can  be  printed  in  a  single  call.  Relational  enti¬ 
ties  are  tables  in  which  the  columns  are  called  attributes.  The  UTRPRT 
utility  attempts  to  print  the  relation  in  a  format  in  which  each  column 
represents  one  attribute  and  each  row  represents  a  single  entry  in  the  rela- 
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Cion.  The  utility  is  not  very  sophisticated,  however,  and  relations  having 
more  attributes  than  can  fit  in  the  width  of  a  page  (128  characters  or  approx¬ 
imately  12  attributes)  will  have  the  trailing  attributes  ignored.  Also, 
string  attributes  are  only  printed  if  they  are  eight  characters  long.  Despite 
its  limitations,  the  UTRPRT  utility  can  be  very  useful  in  viewing  ASTROS  data 
base  relations. 


L*1 1  Kli  V 


The  print  utility  UTUPRT  has  been  written  such  that  any  data  base 
unstructured  entity  can  be  printed  to  the  output  file.  The  calling  sequence 
for  UTUPRT  is: 

CALL  UTUPRT  (  UNSTRUCT,  type  ); 

Unlike  other  data  base  entities,  there  is  no  information  in  an  unstructured 
entity  to  identify  what  type  of  data  is  stored  in  its  records.  The  user, 
therefore,  must  supply  the  TYPE  argument  to  select  the  proper  format  to  use  in 
the  print.  The  following  TYPE'S  are  available: 

TYPE  <  0  prints  only  the  record  length  (in  single  precision 
words)  of  each  record  in  the  entity 

TYPE  -  0  prints  each  record  using  an  integer  format 

TYPE  -  1  prints  each  record  using  a  real  single  precision  format 

TYPE  -  2  prints  each  record  using  a  double  precision  format. 

For  TYPE  values  greater  than  or  equal  to  zero,  each  record  will  be  printed,  in 
its  entirety,  in  the  selected  format.  If,  as  is  topical,  the  record  contains 
mixed  data,  e.g.,  both  integer  and  real  data,  the  user  car  make  multiple  calls 
to  UTUPRT  to  view  first  the  integer  format  and  then  the  real  format.  No 
error*:  will  occur,  but  the  real  data  will  give  spurious  looking  integer'  prints 
and  vice  versa. 


Post-processing  can  often  generate  heated  ^ioate  .voiong  users  regarding 
the  lack  of  foresight  of  the  system  developers  in  failing  to  provide  a  simple 
method  to  obtain  a  particular  response  quantity.  It  is  appropriate  to  address 
this  issue  in  this  section.  A  code  like  ASTROS  (and  NASTRAN)  is  so  general 
that  to  make  all  possible  response  quantities  available  would  take  decades  mf 
effort,  if  it  could  be  done  at  all.  In  fact,  a  mature  finite  element  code 
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like  NASTRAN  is  continuously  adding  new  output  capabilities  as  the  user 
community  dictates.  Naturally,  a  new  code  like  ASTROS  cannot  (and  should  not) 
attempt  to  address  all  these  features.  Instead,  the  ASTROS  designers  consid¬ 
ered  it  important  to  focus  on  design  optimization  and  provide  a  large,  but 
finite,  number  of  options  for  post-processing  outside  this  area.  Among  those 
options,  however,  is  the  capacity  to  obtain  printed  output  for  all  the  data 
storage  forms  on  the  ASTROS  data  base.  In  addition,  the  output  processing 
software  was  carefully  designed  such  that  additional  quantities  are  relatively 
simple  to  install  in  the  system.  Thus,  while  ASTROS  cannot  yet  provide  for 
the  output  of  all  useful  response  quantities,  the  capability  to  provide  them 
at  some  future  date  has  been  addressed  and,  of  more  immediate  importance,  a 
set  of  utilities  has  been  written  to  provide  generic  output  of  the  data  base 
entities.  These  general  utilities,  in  combination  with  the  MAPOL  language, 
make  many  more  quantities  available  to  the  user  than  are  shown  in  the  preced¬ 
ing  subsections.  The  user  is  cautioned,  therefore,  to  keep  in  mind  the 
flexibility  of  the  ASTROS  system  and  not  to  become  overly  constrained  by  the 
limitations  in  the  output  processor.  With  only  a  little  knowledge  of  the 
engineering  software  and  of  the  MAPOL  language,  the  user  will  find  that  a 
large  number  of  additional  quantities  can  be  computed  and  printed. 
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APPENDIX  A 


ASSIGN  DATABASE  DESCRIPTIONS 

This  appendix  contains  the  descriptions  of  the  machine  and  installa¬ 
tion  dependent  parameters  on  the  ASSIGN  DATABASE  entry  for  four  machines  on 
which  ASTROS  is  currently  functional.  The  parameters  that  are  available  at 
each  site  are  listed  and  details  of  their  use  are  presented.  The  user  is 
cautioned  that  these  are  site  dependent  parameters  which  may  be  different  for 
each  installation  even  if  the  host  system  is  the  same.  This  documentation  is 
provided  both  as  an  example  to  the  system  programmer  and  because  the  features 
that  have  been  made  available  on  these  machines  are  very  likely  to  exist  on 
most  machines  that  may  be  used.  The  user  is  referred  to  his/her  ASTROS  system 
manager  for  the  particulars  of  the  interface  between  the  local  host  system  and 
ASTROS . 

The  host  systems  that  are  documented  are: 

(1)  The  MicroVAX  II  and  VAX  8600  using  VMS 

(2)  The  IBM  370  mainframe 

(3)  The  Perkin  Elmer  30xx 

Note  that  the  two  VMS  systems  are  identical. 
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A.l  VMS  IMPLEMENTATION 


The  ASSIGN  DATABASE  entry  supplies  the  ASTROS  system  with  the  root 
name  of  the  data  base  files  <dbroot>,  the  status  of  those  files,  and  a  set  of 
user  parameters.  The  root  name  is  limited  to  eight  characters  in  length,  the 
status  is  one  of  NEW,  OLD  or  TEMP  and  the  set  of  user  parameters  can  be  any  of 
the  following  keyword  commands: 


VOL  -  <vol> 


Names  the  device  and/or  default  directory  on  which 
the  data  base  files  reside. 


DBLKSIZE  -  <n>  CADDB  data  files  block  size  in  words. 


IBLKSIZE  -  <n>  CADDB  index  file  block  size  in  words. 


DELETE  Denoting  that  the  run-time  data  base  files  are  to 

be  deleted  after  the  execution. 

KEEP  Denoting  that  the  run-time  data  base  files  are  to 

be  kept  after  the  execution. 

DCL  Requirements : 


Under  MicroVMS  and  VMS,  the  data  base  files  can  be  explicitly  named  in 
the  FORTRAN  open  statement  or  an  equivalence  between  a  logical  name  and  the 
true  file  name  can  be  established  using  the  DCL  ASSIGN  command: 


$  ASSIGN  physical -name  logical-name 


Both  options  are  used  in  the  VMS  version  of  ASTROS.  If  no  VOL  parame¬ 
ter  is  specified,  the  filenames  dbrootIDX  and  dbrootDOl  are  used  in  the  OPEN 
statement.  These  are  typically  ASSIGNed  to  the  physical  names  in  the  DCL  COM 
file.  When  a  VOL  parameter  is  specified,  however,  a  file  name  with  the 
structure  of  a  physical  file  name  is  used: 


voldbroot . IDX 


voldbroot.DOl 
As  an  example : 

ASSIGN  DATABASE  MULT  SHAZAM  NEW 

would  use  MULTIDX  and  MULTD01  as  file  names  in  FORTRAN  OPEN  statements  where¬ 
as  : 

ASSIGN  DATABASE  MULT  SHAZAM  NEW  VOL  -  $DISK1:(SCR] 
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would  use  $DISK1: [SCR] MULT. IDX  and  $DISK1: [SCR] MULT. DOl  as  filenames  in  the 
OPEN  statements. 

TEMP  Data  Base  Example: 

When  the  status  is  "TEMP,"  a  temporary  data  base  is  created.  Inter¬ 
nally,  the  file  is  not  named  in  the  OPEN  statement  and  has  a  status  of 
"SCRATCH".  Generally,  this  means  that  the  files  will  be  created  in  the  user's 
default  directory.  The  only  legal  optional  parameters  are  DBLKSIZE  and 
1B1XS1ZE.  In  the  example: 

ASSIGN  DATABASE  TEST  PASS  TEMP 

The  data  base  files  will  be  created  using  the  default  block  sizes  and 
deleted  upon  termination  of  the  execution. 

NEW  Data  Base  Example: 

When  the  status  is  "NEW,"  a  new  data  base  is  created.  The  filename 
will  be  formed  from  the  root  name  and,  if  present,  from  the  VOL  option  as 
discussed.  Any  of  the  user  parameters  may  be  used.  As  an  example: 

ASSIGN  DATABASE  TEST  PASS  NEW 

will  create  either  the  files  TESTIDX  and  TESTD01  or,  if  the  DCL  contains  the 
proper  assignments: 

$  ASSIGN  SYS$SCRATCH: TEST. IDX  TESTIDX 

$  ASSIGN  SYS$SCRATCH: TEST. DOl  TESTDOl 

the  files  named  in  the  DCL  ASSIGN  statements. 

The  DELETE  option  will  cause  the  files  to  be  deleted  via  the 
DISP  -  'DELETE'  option  on  the  OPEN  and  CLOSE  statements.  Otherwise  the  files 
will  be  kept. 

OLD  Data  Base  Example: 

When  the  status  is  "OLD,"  an  old  data  base  is  used.  The  physical 
files  that  make  up  the  data  base  must  exist.  Only  the  VOL  parameter  is  legal 
and  the  data  base  files  will  be  kept  after  the  execution  has  terminated.  In 

the  example: 

ASSIGN  DATABASE  TEST  PASS  OLD  VOL  -  $DISK1:[DB] 
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the  preexisting  data  base  files 
$DISK1: [DBJTEST.IDX 
$DISK1: [DB]TEST.D01 
will  be  used  in  the  ASTROS  execution. 

A. 2  IBM  370  IMPLEMENTATION 

The  ASSIGN  DATABASE  entry  supplies  the  ASTROS  system  with  the  root 
name  of  the  data  base  files,  <dbroot>,  the  status  of  those  files,  and  a  set  of 
user  parameters.  The  root  name  is  limited  to  five  characters  in  length,  the 
status  is  one  of  NEW,  OLD  or  TEMP  and  the  set  of  user  parameters  can  be  any  of 
the  following  keyword  commands : 

DBLKSIZE  -  <n>  CADDB  data  file  block  size  in  words. 

IBLKSIZE  -  <n>  CADDB  index  file  block  size  in  words. 

NEW  Data  Base  Example : 

When  the  status  is  "NEW,"  a  new  data  base  is  created.  The  NEW  refers 
to  the  fact  that  the  data  base  itself  is  to  be  initialized.  The  physical 
files  that  make  up  the  data  base  may  exist  or  be  created  with  the  proper  DD 
card.  Other  legal  parameters  are  DBLKSIZE  and  IBLKSIZE.  Here  is  an  example: 

ASSIGN  DATABASE  RICH  RICHPASS  NEW 

JCL  should  be  as  follows: 

//RICHIDX  DD  DSN-RICHDB. INDEX. SPACE-(TRK, 10), DISP-(.CATLG) 

//RICHD01  DD  DSN-RICHDB. DATA, SPACE- (TRK, 50) ,DISP-( ,CATLG) 

In  this  example  a  data  base  with  files  RICHDB.  INDEX  and  RICHDB.DATA  will  be 
created. 

JCL  Requirements: 

On  the  IBM  computer  the  user  must  supply  the  appropriate  JCL  cards  for 
each  data  base  file.  The  DD  names  for  these  cards  are  built  from  the  root 
file  name,  <dbroot>,  as  follows: 
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dbrootIDX  -  index  file 


dbrootDOl  -  1st  data  file 
dbrootD02  -  2nd  data  file 


The  only  required  DD  parameters  for  new  files  are  SPACE  and  D1SP.  The 
user  can  control  the  number  of  data  files  by  including  the  desired  number  of 
DD  cards. 

TEMP  Data  Base  Example: 

When  the  status  is  "TEMP,"  a  temporary  data  base  is  created.  Internal 
to  the  data  base,  there  is  no  difference  between  a  'TEMP'  and  a  'NEW'  data 
base  on  the  IBM.  The  only  difference  is  in  the  JCL  where  the  user  supplies  a 
temporary  file  instead  of  a  permanent  one.  The  only  legal  optional  parameters 
are  DBLKSIZE  and  IBLKSIZE.  Here  is  an  example: 

ASSIGN  DATABASE  RICH  RICHPASS  TEMP  DBLKSIZE-2048  IBLKSIZE-256 


JCL  should  be  as  follows: 

//RICHIDX  DD  DSN— &INDEX, SPACE— (TRK, 10) 
//RICHDOl  DD  DSN-&DATA, , SPACE-(TRK , 50) 

9LP  Patfl-Bagg  Example: 


When  the  status  is  "OLD,"  an  old  data  base  is  used.  The  physical 
files  that  make  up  the  data  base  must  exist.  No  other  parameters  are  legal. 
Here  is  an  example : 


I 


ASSIGN  DATABASE  RICH  RICHPASS  OLD 


JCL  should  be  as  follows : 


//RICHIDX  DD  DSN-RICHDB. INDEX, DISP-OLD 


I 


//RICHDOl  DD  DSN-RICHDB. DATA, DISP-OLD 


a.  3  PERKIN  ELMER. IMPLEMENTATION 

The  ASSIGN  DATABASE  entry  supplies  the  ASTROS  system  with  the  root 
name  of  the  data  base  files,  <dbroot>,  the  status  of  those  files,  and  a  set  of 
user  parameters.  The  root  name  is  limited  to  eight  characters  in  length,  the 
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status  is  one  of  NEW,  OLD  or  TEMP  and  the  set  of  user  parameters  can  be  any  of 
the  following  keyword  commands: 

VOL  -  <vol>  Names  the  disk  volume  on  which  the  data  base  files 

reside . 

DBLKSIZE  -  <n>  CADDB  data  file  block  size  in  words. 

IBLKSIZE  -  <n>  CADDB  index  file  block  size  in  words. 

DELETE  Denoting  that  the  run* time  data  base  files  are  to 

be  deleted  after  the  execution. 

KEEP  Denoting  that  the  run-time  data  base  files  are  to 

be  retained  after  the  execution. 


When  the  status  is  "TEMP,"  a  temporary  data  base  is  created.  Perkin 
Elmer  temporary  files  are  used  so  no  data  are  kept  after  the  run.  The  only 
legal  optional  parameters  are  DBLKSIZE  and  IBLKSIZE. 


ASSIGN  DATABASE  RICHDB  RICHPASS  TEMP  DBLKSIZE-2048  IBLKSIZE-256 


NEW  Data 


Example : 


When  the  status  is  "NEW,"  a  new  data  base  is  created.  The  NEW  refers 
to  the  fact  that  the  data  base  itself  is  to  be  initialized.  The  physical 
files  that  make  up  the  data  base  may  exist  or  be  created.  If  the  files  exist, 
the  DELETE  or  KEEP  parameter  is  used  to  determine  whether  the  existing  files 
are  to  be  deleted  and  reallocated  or  kept.  Two  files  are  used  to  store  the 
data  base.  The  names  of  these  files  are  as  follows: 


vol:dbroot.IDX  -  index  file 


vol.dbroot.D01  -  data  file  1 

The  VOL  parameter  and  the  root  data  base  name  are  used  to  form  the  names. 
Other  legal  parameters  are  DBLKSIZE  and  IBLKSIZE. 

ASSIGN  DATABASE  RICHDB  RICHPASS  NEW  DELETE,  VOL-SYSR 

In  this  example,  a  data  base  with  files  SYSR : RICHDB . IDX  and  SYSR: RICHDB. D01 
will  be  created.  If  existing  files  are  found  they  will  be  deleted  and 
reallocated . 
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When  the  status  is  "OLD,”  an  old  data  base  is  used.  The  physical 
files  that  aake  up  the  data  base  must  exist.  Two  files  are  used  to  store  the 
data  base.  The  names  of  these  files  are  as  follows: 

volrdbroot.IDX  -  index  file 

vol:dbroot.D01  -  data  file  1 

The  VOL  parameters  and  the  root  data  base  name  are  used  to  form  the  names .  No 
other  parameters  are  legal.  Here  is  an  example: 

ASSIGN  DATABASE  RICHDB  RICHPASS  OLD  VOL-SYSR 

In  this  example  a  data  base  with  files  SYSR : RICHDB. IDX  and  SYSR : RICHDB. D01 
will  be  used. 


APPENDIX  B 


This  appendix  contains  the  programmer's  manual  for  the  ASTROS  executive 
language,  MAPOL.  This  manual  is  a  standalone  document  which  presents  the 
syntax  and  features  of  the  MAPOL  language.  It  contains  the  general  informa¬ 
tion  needed  to  make  syntactically  correct  modifications  to  the  ASTROS  standard 
MAPOL  sequence  and  to  write  independent  MAPOL  programs  to  direct  the  ASTROS 
system.  All  variable  types,  statement  forms,  input/output  features  and 
intrinsic  functions  are  presented.  Because  the  manual  is  standalone,  the 
section  numbering  contained  in  this  Appendix  is  inconsistent  with  the  remain¬ 
der  of  the  report  and  a  separate  table  of  contents,  figures  and  tables  have 
been  provided. 
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The  Matrix  Analysis  Problem  Oriented  Language  (MAPOL)  is  a  high  level 
computer  language  that  has  been  designed  to  support,  the  large-scale  matrix 
operations  typically  encountered  in  engineering  analysis.  Its  conceptual 
roots  may  be  traced  to  the  Direct  Matrix  Abstraction  Program  (CHAP) 
capability  found  in  the  NASTRAN®  system  developed  by  NASA  in  the  late 
1960's.  The  EMAP  "language,”  used  to  create  NASTRAN' s  solution  algorithms 
is  very  crude;  however,  it  has  been  a  prime  factor  in  extending  the  life 
cycle  of  the  system.  It  has  done  this  by  providing  a  simple  method  of 
installing  new  code  and  functional  capabilities  into  the  system.  It  also 
affords  the  user  an  opportunity  to  interact  with  the  software. 


MAPOL  has  been  selected  to  provide  the  same  advantages  to  the  ASTROS 
system.  Additionally,  it  extends  the  primitive  EMAP  design  by  assimilating 
the  many  advances  that  have  been  made  in  computer  science  over  the  last  two 
decades. 


MAPOL  is  a  structured  procedural  language  that  directly  supports  high 
order  matrix  operations,  the  manipulation  of  data  base  entities  and  complex 
data  types.  The  syntax  of  the  language  is  similar  to  PASCAL,  and  it  should 
be  easily  learned  by  anyone  familiar  with  FORTRAN  or  PASCAL. 


This  manual  describes  in  detail  all  of  the  features  of  the  MAPOL 
language  and  gives  numerous  exanples  of  their  use. 


1.1  USER  OPTIONS 

In  this  section,  the  different  kinds  of  MAPOL  programs  and  their  uses 
are  discussed.  MAPOL  is  the  control  language  of  the  ASTROS  system  and,  as 
such,  the  multidisciplinary  solution  algorithm  is  sinply  a  MAPOL  program  that 
is  embedded  in  the  system.  The  user  is  free  to  modify  this  standard 
algorithm  and  can  also  create  individual  MAPOL  programs  or  specialized 
procedures. 
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If  an  AS'lKU  analysis  is  not  using  the  standard  solution,  then  a  MAPOL 
program  is  required  as  the  first  part  of  the  input  data  stream.  The  MAPOL 
data  packet  oust  be  formed  as  shown: 

MftEQL  [  <opticn-list>  ]  [;] 


S3?; 

In  this  manual,  all  capitalized  and  underscored  words  (e.g. ,  MAPOL)  must 
appear  exactly  as  they  are  written.  A  symbol  enclosed  in  angle  brackets 
(e.g.,  <option-list>)  represents  one  or  more  choices  to  be  made.  If  the 
symbol  is  enclosed  in  square  brackets  (e.g.,  [<id>]) ,  the  choice  is  optional. 

The  MAPOL  ocraoand,  which  must  be  the  first  statement  in  the  program, 
selects  ocnpiler  options.  These  options  are  shown  in  Table  B-l  where  the  "D" 
indicates  the  default  option. 


TABUS  B-l.  MAPOL  OOMMD  OPTIONS 


NAME 

OPTION 

TJST 

NOLIST 

(D) 

Lists  the  MAPOL  source  program 

SQ 

(D) 

Selects,  or  deselects,  execution 

mss 

after  program  compilation 

As  an  example,  the  statement: 

MAPOL  NOLIST; 

will  cause  the  MAPOL  program  to  be  ocnpiled  and  executed  with  no  listings 
produced,  while  the  statement: 

MAEPL  NOGO; 

will  cause  the  program  to  be  ocnpiled  and  a  listing  of  the  source  code 
produced.  After  cccpi lat ion,  ASTROS  will  terminate  without  executing  the 
program. 
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1.3  THE  STANDARD  ASTROS  SOLUTION 

As  mentioned  earlier,  the  ASTROS  multidisciplinary  solution  algorithm  is 
a  MAPOL  program.  The  code  resides  on  the  ASTROS  system  data  base.  It  is 
retrieved  and  used  whenever  a  MAPOL  program  is  not  found  in  the  input  data 
stream.  A  listing  of  the  standard  solution  algorithm  is  included  in  the 
output  from  the  ASTROS  system  generation  program,  SYSGEN. 

1.4  MODIFYING  THE  STANDARD  SOIUTION 

In  seme  cases,  the  user  may  wish  to  modify  the  standard  ASTROS  solution 
in  order  to,  for  example,  perform  sane  auxiliary  computations  not  currently 
available  or  to  execute  only  a  portion  of  the  solution.  Special  MAPOL 
editing  oermands  allow  for  these  modifications: 

DETf.TE  a  [  ,  b  ] 

REPLACE  a  [  ,  b  ] 

INSERT  a 

DELETE  is  used  to  remove  one  or  more  statements  starting  with  line  "a"  and, 
optionally,  ending  with  line  "b"  inclusively.  REPLACE  performs  a  deletion  of 
the  specified  line,  or  lines,  and  replaces  them  with  any  following  MAPOL 
statements.  The  INSERT  command  allows  any  number  of  MAPOL  statements  to  be 
inserted  after  line  "a". 

For  exairple: 

EDIT; 

INSERT  1 

$  MY  MODIFICATION  $ 

REPLACE  20,23 
A  :=  2  *  B; 

DETETE  101,237 

Note  that  rather  than  entering  the  MAPOL  command,  the  special  EDIT 
declaration  is  used. 

In  the  example,  a  comment  is  added  at  the  beginning  of  the  algorithm  to 
document  the  modification.  Several  lines  (20-23)  are  replaced  by  a  new 
oaiputational  expression,  and  a  larger  block  of  lines  (101-237)  are  removed 
from  the  program. 
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If  tiie  standard  executive  sequence  is  net  selected,  the  MAPOL  compiler 
assumes  that  a  new  program  is  being  created.  This  new  program  may  perform 
any  operations  that  use  any  of  the  matrix  and  data  base  utilities  available 
in  the  ASTROS  system.  All  of  these  are  described  in  subsequent  chapters  of 
this  manual. 


1.6  aatftRy 

Table  B-2  sunmarizes  the  MAPOL  statements  that  have  been  described  in 
this  section,  along  with  their  uses. 

TAHEE  B-2.  SOMBY  OF  USER  OPTIONS 


FUNCTION 


MAPOL  [  <optian-list>  ]  Begin  a  MAPOL  program  and  to  select 

its  name  and  carpi  ler  options 


EDIT 


DKTRIE  a[,b] 
REPLACE  a[,b] 


Terminate  the  MAPOL  program 
Modify  the  standard  solution 
Remove  lines  when  editing 
Remove  and  insert  lines  when  editing 
Insert  lines  when  editing 


INSERT  a 


SECTION  n 

DATA  TYPES  AND  DECLARATIONS 


2.1  nmOlJCITON 

This  section  describes  the  data  types  that  are  available  in  the  MAFOL 
language.  It  discusses  their  specification  during  programming  and  how  they 
are  represented  in  the  ASTROS  machine. 

2.2  DEFINITIONS  AND  NOTATION 

All  programming  languages  are  ccrposed  of  two  kinds  of  symbols.  The 
first  kind  of  symbol  is  an  explicit  part  of  the  language.  In  MAFOL,  such 
symbols  include  special  characters  such  as: 

—  —  *  •  —  • 

and  "reserved  words"  such  as: 

REAL  RELATION  IF  FT  RE  WHIIE 

In  this  manual,  reserved  words  are  indicated  by  capitalized  and 
underscored  names. 

The  second  kind  of  symbol  is  an  identifier,  or  variable  name,  which  may 
be  chosen  by  the  programmer.  Identifiers  are  composed  of  letters  and  digits, 
tut  the  first  character  must  always  be  a  letter.  This  and  other  definitions 
in  this  manual  are  shewn  as: 

<ident>  :==  <letter>  |  <ident>  <letter>  |  <ident>  <digit> 

The  vertical  line  "|"  is  read  as  "or".  This  definition  clearly 
specifies  all  possible  legal  identifiers,  because  no  matter  how  many  times 
the  rules: 

<ident>  :=  <ident>  <letter> 
or 

<letter>  :=  <ident>  <digit> 
are  used,  the  user  must  finally  use  the  rule: 

<ident>  :=  <letter> 

This  final  rule  ensures  that  the  identifier  begins  with  a  <letter>.  In 
MAFOL  <letter>  refers  to  any  of  the  upper  case  letters  from  "A"  to  "Z",  and 
<digit>  to  the  integers  from  "0"  to  "9". 


147 


Note  that  although  this  open-ended  definition  of  an  identifier  (such  a 
definition  is  called  "recursive")  implies  that  arbitrarily  long  names  may  be 
used,  the  MAFOL  compiler  has  an  "implementation  limit"  of  eight  characters 
far  a  variable  name. 

2.3  SIMPLE  DATA  TYPES 

The  MAPOL  language  supports  five  siitple  data  types: 

o  INTEGER 
o  REAL 
o  COMPLEX 
o  LOGICAL 
o  LABEL 

MAPOL  is  a  strongly  typed  language,  and  as  such,  all  variables  must  be 
declared  at  the  beginning  of  a  program  unit.  This  is  done  with  one  or  more 
declaration  statements.  The  syntax  of  a  declaration  statement  is  defined  by 
the  rules  shown  belcw: 

<decl>  :=  <type>  <var-list> 

<type>  :=  REAL  I  INTEGER  |  OCMPIEX  |  LOGICAL  |  LABEL 

<var-list>  :=  <var>  |  <var>,  <var^list> 

Each  simple  variable,  with  the  exception  of  LABEL,  may  be  an  array  with 
one  or  two  subscripts.  This  is  defined  by: 

<var>  |  <ident>  (<subl>)  |  <ident>  (<subl>  ,  <sub2>) 

<subl>  :=  JOflEgB 
<sub2>  :=  INllXEk 

2.3.1  Data  Type  PmgiKK 

INTEGER'S  are  whole  numbers  such  as  157,  83  or  22.  An  INTEGER  may  also 
have  a  sign  associated  with  it  such  as  -47  or  +1024.  The  range  of  integers 
depends  upon  the  ASTROS  host  ccrputer. 

2.3.2.  Data  Type  REAL 

REAL  data  represents  floating  point  numbers.  Such  numbers  include  1.75, 
0.00025,  1.78E-6  and  -3.00271E+36. 
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REAL  numbers  are  represented  in  a  manner  determined  by  the  "machine 
precision"  of  the  host  computer  automatically.  MAPOL,  therefore,  does  not 
distinguish  between  the  REAL  and  DOUBLE  PRECISION  types  such  as  is  found  in 
FORTRAN. 


2.3.3  Data  Type  COMPLEX 

COMPLEX  numbers  are  those  which  may  be  represented  in  the  form: 

a  +  bi 

Because  seme  host  ccrputers  automatically  handle  COMPLEX  data  while  others  do 
not,  MAPOL  and  ASTROS  handle  such  data  in  a  manner  totally  independent  of  the 
host  computer. 

In  the  ASTROS  machine,  both  "a"  and  "b"  are  represented  as  a  pair  of 
machine  precision  floating  point  numbers.  Most  available  mathematical 
functions  operate  on  COMPLEX  data. 

2.3.4  Data  Type  LOGICAL 

LOGICAL  variables  have  a  value  of  "true"  or  "false".  The  ASTROS  machine 
represents  "true"  by  the  integer  value  "1"  and  "false"  by  the  integer  value 
"0"  regardless  of  the  host  computer  convention. 

2.3.5  Data  Type  LABEL 

LABEL'S  are  used  to  define  statement  locations  within  a  MAPOL  program. 
Typically,  they  cure  only  used  with  the  GOTO  statement  (see  Section  4) . 

2.4  COMPLEX  DATA  TYPES 

To  best  support  comprehensive  engineering  analysis  capabilities,  MAPOL 
supports  five  complex,  or  high  level,  data  types: 

O  MATRIX.  IMATRIX 
o  RELATION 
o  UNSTRUCT.  IUNSTRUCT 

All  of  these  types  represent  data  base  entities.  Matrices  and  unstructured 
entities  may  be  handled  only  in  their  entirety  in  MAPOL.  Relations  may  be 
accessed  on  an  entry-by-entry  and  attribute-by-attribute  basis.  Use  of  the 


IMATOIX  and  IUNSTRJCT,  ("I"  for  indexed)  data  types  allows  for  more  efficient 
retrieval  of  data  that  are  accessed  in  a  randan  order. 


2.4.1  Data  Types  MATRIX  and  IMA1RIX 

Matrix  data  base  entities  are  declared  in  a  slightly  different  manner 
fran  the  remaining  data  types.  The  rules  for  their  declaration  are: 

<decl>  :=  MATRIX  <mat-list> 

<mat-l ist>  <mat-list>  ,  <rat-var>  |  <mt-var> 

<mat-var>  :==  [<iderrt>]  |  [<ident>  (sub)  ] 


Note  that  the  matrix  <ident>  is  enclosed  in  square  brackets  (i.e. ,  []  for 
clarity  and  ease-of-reading  of  MAPOL  programs.  Matrix  expressions,  then,  look 
as  they  do  written  in  standard  mathematical  notation.  Matrix  variables  may 
also  be  subscripted  to  allow  multiple  entities  to  be  referenced  using  the 
same  <ident>.  This  feature  is  used  in  ASTROS  to  allow  data  from  multiple 
boundary  conditions  to  be  saved  for  subsequent  sensitivity  evaluation.  There 
is  an  iaplemerrtaticn  limit  of  two  subscripts  which  may  take  on  any  integer 
value  from  1  to  1000.  When  subscripted  matrix  entities  are  used,  the 
executive  system  generates  a  CADOB  entity  name  and  relates  that  name  to  the 
subscript  value.  The  MAPOL  programmer  is  therefore  cautioned  that,  unlike 
other  high  order  variables,  subscripted  matrix  entities  do  not  have  a 
corresponding  CADOB  entity  of  the  same  name. 

2.4.2  Data  Type  RETATTON 

The  most  complex  and  powerful  MAPOL  data  type  is  the  RELATION.  Briefly, 
a  relation  can  be  thought  of  sinply  as  a  table.  The  rows  of  the  table  are 
called  "entries”  and  the  columns  "attributes."  The  CADDB  is  a  collection  of 
such  relations  (Figure  B^l) .  In  the  figure,  a  single  relation,  called  GRID, 
has  been  highlighted.  The  GRID  relation  has  four  attributes:  an  identifi¬ 
cation  number  (GID)  and  three  spatial  coordinates  (X,Y  and  Z) .  The  schemas 
of  relations  that  reside  on  CADDB  are  fixed. 

All  of  the  relations  that  are  generated  by  the  ASTROS  modules  that 
appear  in  the  MAPOL  program  must  be  declared.  The  rules  for  these 
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CADDB  -  RELATIONAL  ENTITIES 


ATTRIBUTES 


GID 

X 

Y 

2 

101 

0.0 

0.0 

0.0 

102 

1.0 

0.0 

0.0 

103 

1.0 

1.0 

0.0 

104 

0.0 

1.0 

0.0 

h-  ENTRIES 


Figure  B-l.  Schematic  Representation  of  Relational  Data 
declarations  are: 

<decl>  :=  RELATION  <rel-list> 

<rel-list>  :  =  <rel-list>  ,  <rel-var>  |  <rel-var> 

<rel-var>  :=  <ident> 

If  the  user  wishes  to  use  the  individual  attributes  of  a  relation,  or  to 
define  a  new  relation,  the  PROJECT  declaration  is  used: 

<decl>  :=  PROJECT  <rel-var>  USING  <att-list> 

<rel-var>  :=  <ident> 

<att-list>  :=  <att-list>  ,  <attname>  |  <attnaine> 

<attname>  :=  <ident> 

The  names  of  each  of  the  attributes,  <attname>,  must  match  those  defined 
in  the  CADDB  schema  if  the  relation  already  exists.  Otherwise,  they  are  used 
to  define  the  schema  for  the  new  relation. 
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As  an  example,  the  GRID  relation  of  Figure  B-l  would  be: 

B0E2B  GID; 

REAL  X,Y,Z; 

PROJECT  GRID  USING  GID,X,Y,Z; 

Note  that  each  attribute  must  be  declared  and  be  of  the  appropriate  type. 


Once  a  relation  and  its  projection  have  been  declared,  specific  entries 
may  be  retrieved.  After  a  retrieved,  any  or  all  of  the  relation's  attributes 
may  be  used  directly  by  variables  of  the  form: 

<relname>  @  <attname> 

This  illustrated  in  the  following  program  segment: 

INTEGER  GID,  ID; 

REAL  X,Y,Z; 

REAL  C1,C2,C3; 

PROJECT  GRID  USING  CID,X,Y,Z; 


ID  :=  GRID@GID; 

Cl  :=  GRID0X; 

C2  :=  GRID@Y; 

C3  :=  GRID€Z; 

•  •  • 

The  value  of  an  attribute  within  a  relation  may  be  modified  if  an 
assignment  is  made  and  then  the  entry  is  written  onto  CADDB  (refer  to 
Section  6.8) . 


2.4.3  Data  .Types.  UNSTP^CT_^0d-JKti51^CT 

Hie  simplest  CADDB  data  structure  is  called  an  UNSIRUCTured  entity.  The 
form  and  content  of  such  an  entity  is  the  responsibility  of  the  ASTROS 
programmer.  The  only  use  of  the  UNSTRUCT  entity  declarations  is  to  type  those 
which  are  used  for  inter-module  ccrtnunicat ions :  UNSTRUCT  entities,  which  may 
not  be  subscripted,  are  declared  with: 


<decl> 

<un-list> 

<un-var> 


=  UNSTRUCT  <un-list> 

=  <un-list>  ,  <un-var>  |  <un-var> 
=  [<ident>] 


P 
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All  of  the  ASTROS  data  base  entities  may  be  divided  into  three  classes: 
(1)  MAFOL  entities,  (2)  HIDDEN  entities,  and  (3)  TEMPORARY  entities.  MAPOL 
entities  are  those  that  are  used  and  appear  in  the  MAPOL  program  such  as 
matrices  or  relations  used  in  calculations  and  any  entity  appearing  as  an 
argument  in  a  functioned  module  cedi.  HIDDEN  entities  represent  data  that 
are  used  by  a  functioned  module  but  whose  contents  are  generated  from 
required  physical  data.  As  an  exanple,  the  GRID  Bulk  Data  are  stored  in  a 
relation  called  'GRID'.  Many  modules  might  wish  to  access  this  GRID  data. 
Requiring  the  GRID  relation  to  appear  in  the  calling  list  of  each  such  module 
is  more  disruptive  them  it  is  beneficial.  As  a  result,  GRID  might  never 
explicitly  appear  in  the  MAPOL  program.  It  must,  however,  be  declared  so 
that  the  CADOB  will  be  properly  initialized.  The  last  entity  type,  the 
TEMPORARY  entity,  is  used  mostly  as  a  "scratch"  area  for  intra-module  use. 
As  such  it  is  created  and  deleted  by  the  module  needing  it. 


In  sunrvary,  all  of  the  MAPOL  and  HIDDEN  entities  must  be  declared  in  the 
MAPOL  program.  TEMPORARY  entities  are  not  declared. 
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SECTION  HI 

EXPRESSIONS  AND  ASSIGNMENTS 

3.1  INTRODUCTION 

In  this  section,  the  relationships  between  the  various  data  types  are 
described.  Of  particular  importance  is  the  manner  in  which  data  are  combined 
by  arithmetic  expressions  and  how  values  are  assigned  to  the  ASTROS  machine 
memory. 

3.2  ARITHMETIC  EXPRESSIONS 

Arithmetic  expressions  are  formulae  for  computing  numeric  values.  An 
arithmetic  expression  consists  of  either  a  single  operand  or  two  or  more 
operands  separated  by  arithmetic  operators. 

3.2.1  Arithmetic  Operators 

MAFOL  supports  five  arithmetic  operators  as  shewn  in  Table  B-3. 
tabu:  B-3.  arithmetic  operators  in  mapol 


OPERATOR 

DESCRIPTION 

+ 

Addition  when  connecting  two  operands.  Unary 

plus  when  preceding  an  operand. 

- 

Subtraction  when  connecting  two  operands. 

Negation  when  precoding  an  operand. 

* 

Multipl ication . 

/ 

Division. 

** 

Exponentiation . 

Successive  operands  must  be  separated  by  operators,  and  two  operators  may  not 
be  used  in  succession. 

3.2.2  Arithmetic  Operands 

Arithmetic  operands  may  be  constants,  symbolic  names  of  constants, 
variables  (including  relational  attributes),  array  elements,  or  function 
references.  Operands  may  also  be  arithmetic  expressions  and  arithmetic 
expressions  enclosed  in  parentheses.  The  data  type  of  an  arithmetic  operand 
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nay  be  INTEGER,  REAL  or  OCMFLEX.  In  sane  cases,  it  may  also  be  MATRIX.  It 
may  never  be  ICGICAL,  IABEL,  RELATION  (without  an  attribute  specification) , 
or  UNSTHJCT. 


3.2.3  Evaluation  of  Arithmetic  Expressions 

Expressions  are  evaluated  from  left  to  right  according  to  the  following 
hierarchy  of  operations: 

FIRST  FUNCTION  EVALUATION 

SECOND  ** 

THIRD  *  AND  / 

FOURTH  +  AND  - 

This  hierarchy  is  used  to  determine  which  of  two  sequential  operations 
is  to  be  performed  first.  If  two  sequential  operations  are  of  equal  rank, 
the  operations  are  performed  from  left  to  right  except  when  the  operators  are 
both  exponentiation  operators,  in  which  case  the  operations  are  performed 
right  to  left.  If  two  sequential  operations  are  of  unequal  rank,  the  higher 
ranking  operation  is  performed  first. 

When  a  unary  minus  or  plus  appears  in  an  arithmetic  expression,  it 
follows  the  same  hierarchy  as  a  minus  or  plus  used  for  subtraction  or 
addition.  For  exanple: 

R  =  -S**T  is  evaluated  as  R  =  -(S**T) 

R  =  -S/T  is  evaluated  as  R  =  -  (S/T) 

R  =  -S+T  is  evaluated  as  R  =  (-S)+T 

The  division  of  operands  in  an  expression  may  result  in  a  truncated 
value  for  integer  operands  or  a  fractional  value  for  non-integer  operands. 
Therefore,  parentheses  should  be  used  when  a  specific  order  of  evaluation 
other  than  left  to  right  is  desired  for  the  operands.  For  exanple,  the 
expression  8*7/4  has  a  resultant  value  of  14;  the  expression  8* (7/4)  has  a 
resultant  value  of  8.  Similarly,  the  expression  3. 0/2. 0*6.0  has  a  resultant 
value  of  9.0;  the  resultant  value  of  the  expression  3. 0/(2. 0*6.0)  is  0.25. 

3.2.4  The  Use  of  Parentheses 

Parentheses  may  be  used  in  arithmetic  expressions  to  specify  the  order 
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of  operation.  This  allows  an  evaluation  that  is  different  from  the  standard 
hierarchy.  Whenever  parentheses  are  used,  the  enclosed  expression  is 
evaluated  prior  to  its  use.  When  such  expressions  are  nested,  the  innermost 
expressions  are  evaluated  first. 

The  expression 

X  :=  A  -  SQRT(B)  /  (C-D)  *  E**2  (F-G) ; 
is  therefore  evaluated  in  the  following  order: 


SQSRT(B) 

->  TEMPI 

(C-D) 

->  TEMP2 

TEMP1/TEMP2 

->  TEMP3 

E  **  2 

->  TEMP4 

TFMP3*TEMP4 

->  TEMP5 

(F-G) 

->  TEMP6 

TEMP5*TEMP6 

->  TEMP7 

A  -  TEMP7 

->  X 

3.2.5  Type  and  Value  of  Arithmetic  Expressions 

Type  conversions  are  performed  when  mixed  expressions  are  evaluated. 
The  final  value  of  an  arithmetic  expression  may  depend  upon  this  type 
conversion.  Tables  B-4  and  B-5  show  the  conversions  that  occur  when  two 
operands  are  combined  with  an  arithmetic  operator: 


TRBtE  B-4.  HJIES  FCR  X  OP  Y,  WHERE  OP  IS  CR  / 


ESS3 

INTEGER 

REAL 

COMPLEX 

INTEGER 

INTEGER 

REAL 

CXMPLEX 

REAL 

REAL 

REAL 

OCMPIEX 

OOMPLEX 

OCMPIEX 

COMPLEX 

OCMPLEX 
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TABLE  B-5.  HITES  KR  EXPCNEKITATICN,  X  **  Y 


SBBa 

REAL 

COMPLEX 

INTEGER 

INTEGER 

REAL 

illegal 

REAL 

REAL 

REAL 

illegal 

COMPLEX 

COMPLEX 

ILLEGAL 

illegal 

Special  rules  apply  to  operations  when  one  or  more  of  the  operands  is  of 
the  type  MATRIX.  These  rules  are  discussed  in  Section  3.5. 

3.3  LOGICAL  EXPRESSIONS 

A  logical  expression  produces  a  logical  data  type  result  with  a  value  of 
TRUE  or  FALSE. 

3.3.1  Logical  Operators 

Table  B~6  lists  the  logical  operators  that  may  be  used  in  logical 
expressions. 

TABLE  B-6.  AUXWABLE  LOGICAL  OPERATORS 


OPERATOR 

DESCRIPTION 

NOT 

Negation  (  Unary  ) 

AND 

Conjunction 

OR 

Disjunction 

XOR 

Equivalence 

logical  operators  must  be  separated  by  logical  operands  except  for  the 
following  two  cases: 

AND  NOT 
OR  NOT 

3.3.2  logical  Operands 

Any  of  the  following  operands  may  be  used  in  logical  expressions: 
o  LOGICAL  CONSTANTS 
o  LOGICAL  VARIABLES 
o  LOGICAL  ARRAY  ELEMENTS 
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o  LOGICAL  FUNCTION  REFERENCE 
o  LOGICAL  EXPRESSION 
o  RELATIONAL  EXPRESSION 

Both  logical  and  relational  expressions  may  be  enclosed  in  parentheses. 

3.3.3  Evaluation  of  logical  Expressions 

Logical  expressions  are  evaluated  based  on  "truth  tables"  shown  in  Table 
B-7.  LI  and  12  are  logical  variables,  T  and  F  signify  TRUE  and  FALSE: 


TABLE  B-7.  EVALUATION  OF  LOGICAL  EXPRESSIONS 


VARIABLES 

RESULT 

LI 

12 

NOT  LI 

LI  OR  12 

LI  MB  12 

LI  XOR  12 

T 

T 

F 

T 

T 

F 

T 

F 

F 

T 

F 

T 

F 

T 

T 

T 

F 

T 

F 

F 

T 

F 

F 

F 

Logical  operators  have  a  hierarchy  similar  to  the  arithmetic  operations: 


FIRST 

LOGICAL  FUNCTION 

SECOND 

NOT 

HURD 

AND 

F0UR3H 

OR 

FIFTH 

XOR 

Any  operation  in  a  logical  expression  may  be  enclosed  in  parentheses; 
the  parenthetical  expression  is  evaluated,  and  the  resulting  value  is  used  as 
an  operand.  Thus,  parentheses  may  be  used  to  alter  the  order  in  which 
operations  are  to  be  performed.  When  parenthetical  expressions  are  nested, 
evaluation  begins  with  the  innermost  set  of  parentheses  and  proceeds  to  the 
outermost  set. 

3.4  RELATIONAL  EXPRESSIONS 

A  relational  expression  uses  relational  operators  to  compare  two 
arithmetic  expressions.  A  relational  expression  produces  a  logical  data  type 
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with  a  value  of  TRUE  or  FALSE.  Thus,  a  relational  expression  may  be  an 
operand  in  a  logical  expression. 


3.4.1  Relational  Operators 

Table  B-8  surmarizes  the  relational  operators  available  in  MAPOL. 


TABLE  B-8.  RELATIONAL  OEtRATCRS  IN  MAPOL 


OPERATOR 

INSCRIPTION 

= 

EQUAL  TO 

o 

NOT  EQUAL  TO 

> 

GREATER  THAN 

>= 

GREATER  THAN  OR  EQUAL  TO 

< 

LESS  THAN 

<= 

DESS  THAN  OR  EQUAL  TO 

3.4.2  Relational  Operands 

Relational  operands  must  be  of  an  arithmetic  type  integer  or  real.  A 
complex  operand  is  permitted  only  when  the  relational  operator  is  =  or  <  >. 

3.4.3  Evaluation  of  Relational  Expressions 

In  a  relational  expression  involving  the  comparison  of  arithmetic 
operands,  each  of  the  arithmetic  operands  is  evaluated  prior  to  testing  the 
relation.  When  the  data  type  of  two  arithmetic  operands  differs,  one  operand 
is  converted  to  the  type  of  the  other  before  the  comparison  is  made.  (See 
Section  3.2.5  for  data  type  conversions. )  The  numeric  values  of  the 
arithmetic  operands  are  compared  as  specified  by  the  relational  operator,  and 
the  resulting  value  is  either  TTOE  or  FALSE. 


Matrix  expressions  are  those  which  combine  two  or  more  matrices  to  yield 
a  matrix  result. 

3.5.1  Matrix  Ctoerators 

MAPOL  allows  four  computational  matrix  operators  as  shewn  in  Table  B-9. 
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TABLE  B-9.  MATRIX  OPERATORS  IN  MAPOL 


OPERATOR 

DESCRIPTION 

A  +  B 

aij  +  bij 

A  -  B 

aij  "  bij 

A  *  B 

^  aikbkj 

-A 

_ j _ 

All  matrices  must  be  (conformable  in  order  to  perform  these  operations, 
the  case  of  addition  and  subtraction,  this  means  that  the  number  of  rows 
columns  in  A  and  B  must  be  the  same.  In  the  case  of  multiplications, 
number  of  columns  of  the  premultiplier  must  equal  the  number  of  rows  in 
postmultiplier . 

Matrix  equations  are  written  with  the  square  brackets  just  as  they  are 
when  declared.  Examples  of  these  equations  are: 

[A]  :=  [B]  *  [C]; 

[X]  :=  [Q(I) ]  *  [Z] ; 

[P(2) ]  :=  [R]  -  [S(2  *  K  +  1)]; 

Matrix  operands  may  also  be  grouped  to  direct  the  order  of  operation. 
Instead  of  the  parentheses  used  in  scalar  expressions,  the  square  brackets 
are  again  used  as  shewn  below: 

[A]  :=  [[B]  +  [C]  *  [D]]  +  [E]; 
t A(I) ]  :=  [[B]  *  [[C]  +  [D]  *  [E]]]  *  [F] ; 

All  matrix  algebra  is  optimized  to  provide  the  most  effective  use  of  computer 
resources.  Matrices  may  also  be  multiplied  by  scalars  or  scalar  expressions 
which  may  be  INTEGER,  REAL  or  COMPLEX.  These  operations  are  written  in  the 
natural  way;  e.g.: 

[A]  :=  (x)  [B]; 

[Q ( 2 ) ]  :=  (R  +  S  *  T)  [C]  +  [D] ; 

All  scalar  multipliers  must  be  placed  on  the  left  as  shown. 

In  addition  to  the  matrix  algebra  operations  of  Table  B-9,  MAPOL  allows 
for  matrix  transpose  and  inverse  using  the  syntax  of  the  following  example: 
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£  Sr  I  s 


[A]  :=  TRANS ([B])  *  [C]  ; 

[X]  :=  INV( [KDG]) *[PG] ; 

[U]  :=  TRANS([A])*INV([A]*TRANS([A]))*CB]; 

Note  that  these  operations  are  functions  and,  as  such,  the  arguments  are 
enclosed  in  parenthesis. 


Only  matrix  operands  may  be  used  in  matrix  expressions  with  the 
exception  noted  in  Section  3.5.1.  The  matrix  expressions  are  evaluated  with 
the  same  hierarchy  as  that  of  arithmetic  types. 

3.6  assiqment  statements 

Assignment  statements  are  used  to  ccnpute  and  assign  values  to  variables 
and  array  elements.  The  syntax  of  a  MAPOL  assignment  is: 

<var>  :=  <expr> 

The  type  of  the  expression  <expr>  is  converted  to  the  type  of  the 
variable  <var>  based  on  the  rules  of  Table  B-10  where  the  following 
definitions  are  used. 

VAL(x)  -  value  of  x 
FIX(x)  -  convert  x  to  an  integer  value 

FLOAT  (x)  -  convert  x  to  a  floating  point  value 
REAL(c)  -  convert  to  the  real  part  of  a  ccrplex  number 
TABES  B-10.  ASSDGNBKT  HOLES  IN  MAFOL 


TYPE  OF  <VAR> 

TYPE  OF  <EXFR> 

ASSIGNMENT  RULE 

INTEGER 

VAL(<EXPR>)  INTO  <VAR> 

REAL 

FLOAT  (VAL  (<EXPR>))  INTO  <VAR> 

OCMPLEX 

FIX(REAL(VAL(<EXFR>)))  INK)  <VAR> 

REAL 

■  .  ''  *  M 

FLOAT  (VAL(<EXPR>) )  INK)  <VAR> 

REAL 

VAL(<EXPR>)  INK)  <VAR> 

COMPLEX 

REAL  (VAL  (<EXFR>) )  INK)  <VAR> 

OCMPLEX 

INTEGER 

FLOAT (VAL(<EXFR>)  INK)  REAL  <VAR> 

REAL 

VAL(<EXFR>)  INK)  REAL(<VAR>) 

OCMPLEX 

VAL(<EXFR>)  INK)  <VAR> 
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CONTROL  STATEMENTS 


4.1  INTRODUCTION 

Control  statements  are  statements  used  to  alter  and  control  the  normally 
sequential  execution  of  MAPOL  instructions.  There  are  five  MAPOL  control 
statements: 

o  GOTO 
o  FOR  ...  DO 
O  WHILE  ...  DO 
o  IF  ...  THIN  ...  Hi SE 
o  END  ,  ENDP 

4.2  THE  UNOONDITIONAL  GOTO  STATEMENT 

The  GOTO  statement  causes  the  MAPOL  program  to  jump  unconditionally  to 
the  specified  statement  label.  This  label  must  exist  in  the  same  program 
unit  (see  Section  6)  as  the  GOTO  statement.  The  label  identifier  must  also 
have  been  declared  in  the  program  unit’s  specification  statements.  The 
general  syntax  is: 

GOTO  <label>; 

where  <label>  is  any  legal  identifier  that  has  been  declared. 

The  label  is  denoted  by  <label>:  followed  by  any  valid  MAPOL  statement. 
As  an  example; 

IF  A  <  B  GOTO  SKIP; 

SKIP:  C:=-  B  -A; 

Note  that  the  label  must  be  followed  by  a  colon. 

4.3  ITERATION 

It  is  often  necessary  to  execute  a  group  of  statements  repeatedly. 
Generally,  although  the  statements  themselves  remain  the  same,  the  data  on 
which  they  operate  changes.  This  iteration  or  "looping"  must  terminate  after 
a  finite  number  of  iterations;  therefore,  a  decision  must  be  made  to 
deternuuic  whether  to  continue  or  terminate  the  loop.  MAPOL  supports  two 
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iteration  forms:  FOR.  ..DO  and  WHIIE...DO.  Each  is  described  in  this 

section. 

4.3.1  .« DO  ,.iocp 

It  is  often  necessary  to  perform  a  set  of  calculations  a  specific  number 
of  times,  and  that  number  does  not  depend  on  the  statements  within  the  loop. 
Consider  the  problem  of  sunning  the  first  20  integers: 

20 

SUM  =  2  n 
n-1 

Such  a  problem  is  ideally  suited  to  the  FOR  loop  and  could  be  evaluated  using 
the  following  MMOL  program: 

MMOL 


TOP  :=  20; 

SUM  :=  0; 

FOR  N  =  1  TO  TOP  DO 
SUM  :=  SUM  +  N; 

ENDDO: 

IRINT  ("(IX,  'SUM  =  '  ,15)  "  ,  SUM  ); 

a©; 

The  general  syntax  of  the  FOR  loop  is 

FOR  <var>  =  <expl>  TO  <exp2>  [  BY  <exp3>  ]  DO 


SffiQO; 

The  loop  counter  <var>  is  called  the  control  variable  and  may  be  any  integer 
or  real  variable.  <expl>,  <exp2>  and  <exp3>  are  called  the  initial,  terminal 
and  incremental  parameters,  respectively.  Note  the  incrementation  clause 

BY  <exp3> 

is  optional,  as  in  the  example.  If  it  does  not  appear,  the  increment  is 
taken  to  be  one.  Each  loop  terminates  with  the  instruction  ENDDO.  The 
following  rules  must  be  noted: 

(1)  If  <expl>  >  <exp2>,  then  the  body  of  the  loop  will  still  be  executed 
once. 
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(2)  The  type  of  the  control  variable  and  the  three  expressions  most  be 
the  same. 

(3)  The  control  variable  may  not  be  redefined  inside  of  the  loop. 


4.3.2  The  WHIIE.  .  .DO  loop 

Another  way  to  execute  a  group  of  statements  repeatedly  is  with  a  WHILE 
loop.  This  type  of  loop  is  used  to  repeat  groups  of  statements  that 
typically  modify  a  more  caiplex  condition  than  the  simpler  incrementation  of 
the  FOR  loop.  As  an  example,  suppose  it  is  desired  to  compute  the  cube  root 
of  a  number  "X".  If  "a"  is  an  approximation  to  the  answer,  then 

2 

b  =  2a  +  x/a 
T~ 

is  an  inproved  guess.  The  program  of  Figure  B-2  will  compute  the  cube  root 
of  10  to  3  significant  figures: 


MAPOL 

REAL  X,  OLD,  NEW,  TEMP,  EPS; 

X  :=  10; 

OLD  :=  2;  $  THE  INITIAL  GUESS  $ 

NEW  :=  1; 

EPS  :=  0.001;  $  THE  CONVERGENCE  CRITERION  $ 

WHIIE  ABS  (OLD-NEW)  >  EPS  DO 
TEMP  :=  NEW; 

NEW  :=  (2.0*OLDfX/OLD**2)/3.0; 

OLD  :=  TEMP; 

ENDDO; 

PRINT  (  "  (IX, 'X,CUBERT(X)  \2F15.5)"  ,  X  ,  NEW  ); 
END; 

Figure  B-2.  A  MAPOL  Program  to  Ocnpute  Cube  Roots 
The  general  form  of  the  WHILE  loop  is: 

WHILE  <cond>  DO 


ENDDO; 


The  <ocnd>  is  any  conditional  expression  that  results  in  a  logical  outcome. 


4.4  TOE  IF  STATEMENT 

It  is  often  necessary  in  a  program  to  specify  two  or  more  alternatives 
that  must  be  selected  depending  upon  other  program  results.  The  IF  statement 
allows  this  selection.  There  are  three  types  of  IF  statements  in  MAPOL: 

o  LOGICAL  IF 
o  BLOCK  IF 

o  IF  ...  THEN  ...  ELSE 

4.4.1  The  Logical  IF 

The  logical  IF  is  used  if  a  single  expression  is  to  be  executed  based  can 
a  particular  condition.  The  syntax  of  this  statement  is 

IF  <cond>  <statement> 

where  <oond>  is  any  logical  expression  and  <statement>  is  any  legal 
executable  MAPOL  statement  except: 

1)  A  WHILE  or  FOR  loop 

2)  Another  logical  IF 

3)  An  END.  ENDP.  ENDIF.  or  ENDDO  instruction 

4)  A  FROC  definition 
Examples  of  the  logical  IF  are: 

IF  A<B  FRENTC'IX,  'A  =  '  ,15) M  ,  A  ) ; 

IF  ABS  (NEW-OLD)  >  EPX  NEW  :=  OLD; 

IF  A  AND  B  OR  C  CALL  UIMERT  (,  [KMAT]) ; 

4.4.2  The  Block  IF 

It  is  often  necessary  to  perform  a  number  of  instructions  based  on  a 
given  condition .  This  can  be  accomplished  by  a  block  IF  statement,  the 
syntax  of  which  is: 

IF  <cond>  THEN 


ENDIF; 
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Rather  than  a  single  statement,  the  body  on  the  block  may  contain  any 
number  of  MAPOL  statements,  for  example: 

IF  A  <  B  THEN 
C  :=  1.0; 

D  :=  4.0; 

CALL  UTMFKT  ( ,  [JMAT] )  ; 

ENDIF: 


4.4.3  The  IF. .  .THEN. .  .ETSE 

The  IF. .  .THEN. .  .ELSE  statement  is  used  to  execute  one  of  two  separate 
blocks  of  code  depending  on  a  specific  condition.  The  syntax  of  this 
statement  is: 

IF  <cond>  THEN 


BLOCK  1 


ELSE 


BLOCK  2 


ENDIF: 

If  the  ^cond>  is  satisfied,  the  instructions  in  BLOCK  1  are  executed.  If 
<cond>  is  not  satisfied,  then  BLOCK  2  is  executed. 

4.4.4  Nested  IF  Statements 

IF  statements  may  be  nested  to  any  level.  That  is,  each  IF  or  ELSE  part 
may  contain  another  IF  statement,  as  shown  below: 

IF  A  >  B  THEN 
A  :=  100; 

ELSE  IF  C  <  D  THEN 

C  :=  200; 

ELSE 

C  :=  0; 

ENDIF; 


ENDIF; 


Note  that  each  IF _ THEN. .  .ELSE  must  terminate  with  its  own  ENDIF.  It  is 

helpful  to  indent  code  so  that  the  blocks  are  obvious. 


4.5  THE  BO  AND  ENDP  STA1 

The  END  and  ENDP  statements  are  used  to  indicate  the  physical  end  of  a 


MAPOL  program  or  in-line  procedure,  respectively. 


SBCTICN  V 

INTOT/OOTFUT  STATEMENTS 


5.1  INTRODUCTION 

The  MAPOL  compiler  does  not  have  facilities  for  input  in  the 
programing  language.  All  input  is  handled  by  the  ASTROS  executive  system. 
MAPOL  does,  however,  allow  direct  output  to  the  system  print  device  as 
defined  by  the  ASTROS  host  ccrputer.  Output  is  merged  with  the  same  file 
that  contains  all  of  the  other  ASTROS  print  output. 

5.2  THE  PRINT  STATEMENT 

Output  printing  is  requested  with  the  PRINT  statement,  the  syntax  of 
which  is: 

PRINT  (  < forma t>  [,  <print-list>]  ); 

In  order  to  allow  maximum  power  and  flexibility  while  minimizing  training, 
the  <format>  specifications  used  by  MAPOL  are  identical  to  those  used  by 
FORTRAN.  The  format  is  entered  as  a  literal  string,  enclosed  by  quotation 
marks;  i.e. , 

§  "(IX, 5E1.6) " 

"(//IX,'  X=  ' ,F15.5) " 

The  <print-list>  is  a  list  of  one  or  more  defined  variables  to  be  printed. 
If  only  heading  information  is  being  printed,  the  <print-list>  may  be 
emitted.  Examples  of  print  statements  are: 

FRINT  ("(1X,EI5)",I,J,K) ; 

which  prints  the  three  integer  variables  I,  J  and  K  using  the  indicated 
format  and 

FRINT  ("(IX, 'THIS  IS  A  HEADER')"; 
which  prints  the  message  "THIS  IS  A  HEADER". 

ASTROS  does  not  attempt  to  check  the  validity  of  a  format  statement  with 
the  data  types  being  printed.  As  a  result,  it  is  possible  to  cause  a  FORTRAN 
run-time  error  condition. 
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SECTION  VI 

raOCEDURES  AND  FUNCTIONS 


6.1  INTRODUCTION 

One  of  the  most  powerful  features  of  a  programming  language  is  the 
ability  to  define  "procedures, "  or  subroutines,  that  perform  specialized 
tasks.  Sane  procedures  with  special  characteristics  are  called  "functions." 
Each  MAFOL  main  program,  procedure  or  function  is  called  a  "program  unit." 
This  section  explains  the  use  of  procedures  and  provides  examples  of  their 
use. 


6.2  PROGRAM  UNITS  AND  SCOPE  OF  VARTABTES 

In  Section  1,  a  MAFOL  program  was  defined  very  simply  as  having  the 

form: 

MAFOL 


END; 

This  form  is  called  a  main  program.  A  main  program  may  also  contain  other 
program  units  that  may  be  procedures  or  functions  such  as: 

MAFOL 

FROC  A; 


ENDP; 

REAL  FUNC  B; 


ENDP; 


END; 

All  procedures  must  appear  in  the  main  program  before  any  executable 
statements,  but  after  the  declaration  statements. 


171 


Each  procedure,  or  function,  may  have  variable  declarations  within  it. 
If  it  does,  these  variables  are  called  "local”  to  the  procedure.  Variables 
defined  in  the  main  program  are  called  "global."  These  definitions  are 
called  the  scope  of  the  variables.  The  value  of  a  local  variable  is  not 
available  outside  of  the  procedure  in  which  it  is  defined.  Examples  are 
shown  after  some  additional  def initials. 


6.3  DEFINING  A  PROCEDURE 

A  procedure  is  defined  in  MAFOL  by  a  declaration: 


FROC  <procname>  [  <params>  ] ; 

where  <procname>  is  any  identifier.  If  this  name  is  the  same  as  a  run-time 
procedure,  the  new  procedure  will  be  used.  <params>  is  an  optional  list  of 
formal  parameters  that  are  used  to  pass  information  into  and  retrieve 
information  from  the  procedure. 

<params>  :=  (  <paramlist>  ) 

<parmlist>  :=  <ident>  |  <paramlist>  ,  <ident> 

Examples  are: 


FROC  MYFROC  (  A  ,  B  ,  C  )  ; 

FROC  GETONE  ; 

The  FROC  statement  is  called  the  procedure  "head".  It  is  followed  by  the 
procedure  "body"  and  an  EMDP  statement: 

FROC  TEST; 

PROCEDURE  BODY 

This  defines  the  procedure  program  unit.  As  an  example,  to  find  the 
square  root  of  a  real  number 

a  =  (b)1/2 

a  Newton-Raphson  iteration  technique  can  be  used 

*1*1  =  «n  -  <4  "  b>/2an 

The  iteration  proceeds  to  the  desired  accuracy  as  determined  by 

|  an  -  |  <  EPS 

A  MAFOL  procedure  for  this  is  shown  in  Figure  3. 
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FROC  USQRT(A,SQRTA)  ; 

REAL  A,SQRIA,EPS,DEITA,AOID; 

EPS  :=  O.OOOl; 

SQRTA  :=  1.0; 

DELTA  :=  1.0; 

WHILE  ABS  (DELTA)  >EPS  DO 
AOLD  :=  SQRTA; 

SQRTA  :=  AOLD  -  ( (AOLD*AOLD-A)/(2.0*AOLD) )  ; 
DELTA  :=  SQRTA  -  AOLD; 

ENDDO; 

ENDP; 


Figure  B-3.  A  MAPOL  Procedme  to  Determine  the  Square  Rxt  of  a  Nutter 


6.4  INVOKING  A  PROCEDURE 

Once  procedures  are  defined,  they  may  be  used  anywhere  within  the  main 
program  or  in  a  subsequent  procedure.  This  is  done  with  the  MAPOL  statement: 

CALL  <procname>  [  <userparm>  ] ; 

where  <procname>  is  one  of  the  defined  procedures.  Hie  optional  <userparm> 
are  the  actual  user-defined  variables  to  be  passed  to  the  procedure.  They 
must  agree  in  number  and  type  with  the  FRPC  definition.  Parameters  are 
passed  by  name.  For  example,  a  program  segment  using  the  square  root 
procedure  of  Figure  3  is 


MAPOL 


REAL'  X,Y; 


X  :=  5; 

CALL  USQKT(X,Y)  ; 


END; 


The  parameters  "X"  and  "Y"  are  the  actual  variables  that  will  be  used  in 
place  of  the  formal  parameters  in  the  procedure  definition. 


6.5  FUNCTION  PROCEDURES 

A  special  kind  of  procedure  that  can  have  only  one  output  value  is 
called  a  FUNCTION.  Because  it  is  a  value,  the  type  of  the  function  must  be  a 
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declared.  Valid  types  are  integer,  real,  ccrplex  or  logical.  Therefore,  the 
function  head  differs  slightly  from  that  of  the  procedure: 

<type>  HJNC  <funcname>  [  <pararrts>  ] 

Again,  <type>  must  be  included  and  all  other  rules  are  the  same  as  those  for 
a  regular  procedure. 

Unlike  procedures,  functions  are  invoked  with  their  name  and  arguments 
eis  in  FORERAN  and  they  can,  therefore,  be  used  directly  in  assignment 
statements  and  expressions,  e.g. , 

A  :=  SIN(X) ; 

B  :=  X  +  Y  *  SQRT(Z) ; 


In  addition  to  the  user  defined  procedures  and  functions  within  a  MAPOL 
main  program  unit,  MAPOL  provides  a  set  of  predefined  functions  and 
procedures  to  perform  certain  tasks  in  a  similar  manner  to  other  high  level 
languages  such  as  FORTRAN.  These  "intrinsic”  procedures  are  in  addition  to 
the  engineering  modules  defined  as  part  of  the  ASTROS  system  generation 
process.  The  set  of  intrinsic  procedures  within  the  MAPOL  language  can  be 
broken  into  three  groups:  intrinsic  mathematical  functions,  intrinsic 
relational  procedures  and  general  intrinsic  procedures.  Each  group  is 
discussed  separately  in  the  following  sections. 

6.7  INTRINSIC  MATHEMATICAL  FUNCTOR 

Table  B-ll  shows  the  list  of  intrinsic  mathematical  functions  available 
in  MAPOL.  These  functions  make  up  the  mathematical  function  library  within 
the  MAPOL  language  and  provide  the  user  with  the  capacity  to  perform  a  wide 
variety  of  tasks  within  the  MAPOL  program  units.  With  very  few  exceptions, 
the  MAPOL  mathematical  functions  are  identical  in  form  to  those  in  the 
FORTRAN  language;  the  exceptions  are  noted  in  Table  B-ll.  Trigonometric 
functions  in  MAPOL  use  radian  angles  as  arguments  and  result  in  radian  angles 
just  as  in  FORTRAN.  All  MAPOL  functions  are  "generic"  in  the  sense  that  they 
support  multiple  data  types  (INTEGER,  REAL)  as  arguments  and  perform  the 
appropriate  conversions. 


TABLE  B-ll.  1NIKI16IC  MKIHEMKFICAL  FINCTXGNS  IN  MAPOL 


DESCRIPITON 

EXAMPLE 

ABS 

ACOS 

AS  IN 

ATAN 

COS 

OOSH 

EXP 

IMAG 

IN 

LOG 

MAX 

RE 

SIN 

SINH 

s oft 

TAN 

TANH 

Absolute  Value 

Arccpsine 

Arcsine 

Arctangent 

Cosine 

Hyperbolic  Cosine 

Exponential 

Imaginary  Cctrponent 
(Equivalent  to  FORTRAN  AIMAG) 
Natural  Logarithm 
(Equivalent  to  FORTRAN  IOG) 
Octiinon  Logarithm 
(Equivalent  to  FORTRAN  IOG10) 
Selects  Largest  Value 

Real  Ccrrponent 

(Equivalent  to  FORTRAN  REAL) 

Sine 

Hyperbolic  Sine 

Square  Root 

Tangent 

Hyperbolic  Tangent 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

=  ABS  (  B  ) ; 

=  ASIn(  B  ; 

=ATAN(  B  ) ; 

=  00S(  B  ; 

=  GQSH(  B  ) ; 

=  EXP(  B  ) ; 

=  IMAg(  B  ) ; 

=  IN  (  B  ) ; 

=  LOG(  B  ) ; 

=  MAX(  B.  c,  ...); 

=  RE(  B  ) ; 

=  SIN(  B  ) ; 

=  SINH(  B  ) ; 

=  SQRT  B  ; 

=  TAN(  B  )  ; 

=  T/NH  (B  ) ; 

6.8  INTRINSIC  RELATIONAL  PROCEDURES 

As  discussed  in  Section  2.4,  MAPOL  has  provided  a  means  by  which  individual 
relational  entries  (rcw/attribute  combinations)  may  be  accessed  directly. 
Table  B-12  shows  the  argument  lists  to  the  set  of  intrinsic  procedures 
provided  to  enable  the  MAPOL  prograitmer  to  open  relations,  to  retrieve 
particular  rcws,  to  update  or  add  rcws  and  to  close  the  relation.  In 
combination  with  the  RELATION  and  LRQJECT  declarations,  these  procedures 
provide  a  direct  data  base  interface  that  nearly  matches  the  full  relational 
application  programming  interface  in  CADDB.  The  equivalent  CADDB  application 
interface  routine  is  listed  in  Table  B-12  for  completeness.  There  is  an 
implementation  maximum  of  five  open  relational  variables  at  any  time  during 
the  execution  of  a  MAPOL  program. 

TABLE  B-12.  INTRINSIC  RELATIONAL  PROCEDURES  IN  MAPOL 

A.  RECEND 

Calling  Sequence:  CALL  RECEND  (  <rel-var>  ) ; 

Purpose:  To  end  the  definition  of  relational  conditions.  (A  maximum 
of  10  may  be  applied  per  relation) . 

CADDB  equivalent:  REENDC 

B.  RELCND 

Calling  Sequence:  CALL  RELCND  (<rel-var>,  <attr>,  <relop>,  <value>) ; 
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TABLE  B-12.  INIKENSIC  RELATIONAL  PROCEDURES  IN  MAFOL  (Continued) 


Purpose:  To  define  relational  conditions. 

<attr>  is  an  attribute  name  in  quotation  marks  ' 

<relop>  is  one  of  "GT”,  "LT",  "FQ" ,  "NE" ,  "GE",  "IE" 

<value>  is  the  conditioned  value 

(A  maximum  of  10  may  be  applied  per  relation) 

CADOB  equivalent:  REOOND 

C.  KELADD 

Calling  Sequence:  CALL  RELADO  (  <rel-var>  )  ; 

Purpose:  To  add  a  tuple  to  a  relation. 

CADOB  equivalent:  READD  4 

D.  REXfND 

Calling  Sequence:  CALL  RELCND  (  <rel-var>  )  ; 

Purpose:  To  close  a  relation. 

CADOB  equivalent:  DBCLQS  t 

E.  KELGET 

Calling  Sequence:  CALL  RET  OFT  (  <rel-var>,  <status>  ) ; 

Purpose:  To  retrieve  a  tuple  from  an  open  relation. 

<status>  is  an  integer  variable  that  is  non-zero  if  an  error 
occurred. 

CADOB  equivalent:  REGET 

F.  KELUFO 

Calling  Sequence:  CALL  REUJPD  (  <rel-var>  ) ; 

Purpose:  To  replace  a  previously  retrieved  relational  tuple  with 
modified  values. 

CADOB  equivalent:  REUPD 

G.  REHJ5E  *  j 

Calling  Sequence:  CALL  REI.USE  (  <rel-var>,  <ntuple> , 

<status>  ) ; 

Purpose:  To  open  a  relation. 

<ntuple>  is  an  integer  variable  which  contains  the  number  of 

tuples  in  the  relation  on  output.  ‘ 

<status>  is  an  integer  variable  that  is  non-zero  if  an  error 
occurred. 

CADOB  equivalent:  DBOFEN 

I 

1 

! 
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Figure  B~4  shows  a  sirrple  MAPOL  procedure  that  manipulates  a  relation 
called  GFOINT.  Two  rows  are  placed  in  the  relation  followed  by  a  conditional 
retrieval  to  obtain  one  of  the  tuples  for  use  in  an  additional  operation. 


6.9  GENERAL  INTRINSIC  PROCEDURES 

Two  other  intrinsic  procedures  have  been  provided  to  enhance  the  utility 
of  MAPOL:  the  EXIT  and  TRNSPOSE  procedures.  The  first  is  identical  to  the 
common  FORTRAN  extension  EXIT.  The  MAPOL  statement 
CALL  EXIT; 

will  cleanly  terminate  the  ASTROS  execution  without  requiring  the  user  to 


177 


junp  to  the  end  of  the  MAPOL  sequence.  This  is  particularly  useful  when  an 
edited  standard  solution  sequence  is  used.  The  TONS  POSE  procedure  provides 
an  additional  MATRIX  operation  that  is  otherwise  missing  front  the  language. 
While  the  operation 

[A]  :=  TOANS(  B  )  *  [C]  ; 

is  available  within  the  syntax  of  MAPOL  expression,  the  operation 
[A]  :=  TRANS  (  B  )  ; 

is  not.  The  intrinsic  procedure  TONS  POSE  allows  this  matrix  operation  to  be 
performed.  The  form  of  TONE  POSE  is 

CALL  TONSPOSE  (  [A],  [TOANSA]  ); 

where  [A]  is  the  matrix  to  be  transposed  and  [TOANSA]  is  the  resultant 
transposed  matrix. 
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APPENDIX  C 


ANNOTATED  STANDARD  EXECUTIVE  SEQUENCE 

This  appendix  contains  a  description  of  the  standard  executive  (MAPOL) 
sequence  for  the  ASTROS  system.  This  single  MAPOL  program  is  capable  of 
performing  any  and  all  of  the  ASTROS  system  capabilities.  As  a  result,  the 
sequence  is  quite  long  (over  1500  lines)  and  appears  very  complicated.  Study 
of  the  MAPOL  sequence  will  reveal,  however,  that  many  of  the  program  struc¬ 
tures  are  used  repeatedly  throughout  the  sequence.  The  purpose  of  this 
appendix  is  to  provide  a  familiarity  with  the  standard  sequence  sufficient  to 
make  modifications  to  that  sequence.  This  documentation  does  not  take  the 
place  of  the  Programmer's  Manual,  but  is  useful  in  that  the  relationships 
among  the  engineering  modules  and  the  matrix  expressions  in  the  standard 
sequence  are  shown.  Thus,  the  user  can  more  readily  identify  where  particular 
quantities  that  may  be  of  interest  are  computed  and  stored. 

The  principal  MAPOL  statements  in  the  standard  sequence  are  identified 
by  line  number  and  described  in  some  detail.  Line  numbers  that  do  not  appear 
in  this  presentation  are  omitted  because  it  is  felt  that  the  statement  or 
statements  are  sufficiently  readable  in  the  context  of  the  surrounding  code. 
Program  blocks  that  appear  repeatedly  will  be  described  each  time  to  enhance 
readability  and  for  completeness.  The  MAPOL  sequence  is  self -documented  with 
comments  and  indentation  is  used  to  identify  all  block  program  structures. 
These  features  are  helpful  in  identifying  the  top  of  major  program  blocks  and 
in  following  the  structure  of  the  program.  In  general,  it  is  felt  that, 
despite  i’-s  seeming  complexity,  the  MAPOL  sequerce  that  directs  the  ASTROS 
procedure  is  understandable  and  much  more  readable  than  its  NASTRAN  counter¬ 
parts  . 

The  user  is  cautioned  that,  due  to  ongoing  modification,  the  standard 
■quence  shown  in  this  appendix  and  used  for  this  discussion  may  NOT  be 
identical  to  the  actual  standard  sequence.  The  sequence  included  will  be  very 
similar  and  should  be  sutficient  for  discussion.  It  is  imperative  that  the 
user  wanting  to  mod’ fy  the  standard  sequence  use  the  line  numbers  that  appear 
in  the  standard  sequence  listing  contained  in  the  system  generation  (SYSGEN) 
output  rather  than  those  in  this  appendix. 


All  line  numbers  reference  those  shown  in  the  standard  MAPOL  sequence 
listing  of  Figure  C-l.  The  phrase  "matrix  [A]  is  equivalenced  to  matrix  [B]" 
is  used  frequently  in  this  discussion.  This  denotes  a  special  MAPOL  feature 
in  which  the  operation  "[A]:-[B];"  is  performed  using  the  CADDB  DBEQUV  utility 
rather  than  an  actual  copy  operation  taking  place. 

C.l  VARIABLE  DECLARATIONS 

LINE  2 .  Identification  line  showing  the  last  modification  date  of  the 
standard  sequence.  If  the  user's  SYSGEN  output  has  a  different  date,  the 
sequence  shown  differs  from  the  actual  sequence  to  some  degree. 

LINES  4  TO  180.  The  MAPOL  language  requires  that  all  variables 
appearing  in  the  MAPOL  sequence  be  declared.  Every  scalar  and  high  order 
variable  that  appears  anywhere  in  the  sequence  is  declared  in  these  lines. 
The  declarations  are  grouped  by  association  with  a  particular  module  or 
discipline.  Each  such  group  is  labeled  with  a  leading  comment. 

NOTE:  User  defined  MAPOL  procedures  would  be  inserted  into  the  standard 
sequence  following  Line  180. 

C.2  PREFACE  MODULES 

LINE  190.  Calls  the  Solution  Control  interpreter  to  process  the 
SOLUTION  packet  and  to  load  the  CASE  relation  with  requested  disciplines  and 
subcases . 

LINE  191.  Calls  the  Input  File  Processor  module  to  process  the  BULK 
DATA  packet,  to  load  the  input  data  onto  the  data  base  and  to  generate  basic 
collections  of  data  including  the  transformation  matrices  (TMAT  relation)  and 
the  basic  nodal  data  (BGPDT  relation) . 

LINES  192  TO  195.  Make  calls  to  the  structural  set  definition  module, 
MKUSET,  for  each  boundary  condition  in  the  Solution  Control.  This  module 
fills  the  USET  entity  and  creates  the  partitioning  vectors,  [Pxxx] ,  and 
vectors  of  enforced  displacement,  [YS] ,  needed  to  perform  matrix  reductions 
of  the  structural  matrices. 

LINE  199.  Calls  the  element  summary  table  generation  module,  MAKEST, 
to  form  the  element  summary  data  for  each  structural  element  in  the  model. 
Preliminary  design  variable  linking  is  also  performed  in  this  module. 
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LINE  200.  Calls  the  element  sensitivity  matrix  generation  module, 
EMG.  This  is  the  fundamental  element  processing  module  in  ASTROS.  It  gener¬ 
ates  all  the  local  design  variable  (element)  sensitivities  for  stiffness, 
mass,  thermal  loads  and  stress  and/or  strain  constraints  (KELM,  MELM,  TELM, 
SMAT,  respectively)  for  all  the  structural  elements. 

LINE  201 .  Calls  the  generic  bulk  data  preface  module,  PFBULK.  This 
module  performs  preliminary  error  checking  for  a  number  of  disciplines  in 
order  to  avoid  costly  error  checking  within  the  design  iteration  loop. 
Preliminary  collections  of  data  are  also  formed  in  some  cases. 

LINE  206.  Calls  the  first  phase  element  sensitivity  matrix  assembly 
module,  EMAl .  This  module  assembles  the  data  from  EMG  into  the  global  design 
sensitivities  for  stiffness  and  mass  (DKVI  and  DMVI ,  respectively). 

LINE  211.  Calls  the  loads  sensitivity  assembly  module,  LODGEN.  This 
module  assembles  the  element  thermal  loads  sensitivities  from  EMG  (TELM) ,  the 
global  mass  sensitivities  from  EMAl  (DMVI)  and  the  design  invariant  loads  from 
the  bulk  data  (FORCE,  MOMENT,  etc.)  into  the  global  simple  loads  sensitivities 
for  all  loads  defined  in  the  bulk  data.  Final  loads  assembly  occurs  in  the 
subsequent  boundary  condition  loops  in  the  GTLOAD  module. 

LINES  216  TO  223.  Call  the  preface  aerodynamics  routine,  PFAERO,  to 
compute  the  aerodynamic  matrices  for  both  steady  and  unsteady  aerodynamics. 
The  call  appears  in  a  loop  which  is  controlled  by  PFAERO.  The  module  will  be 
called  once  for  each  Mach  number  used  in  steady  aeroelastic  disciplines  in  the 
Bulk  Data . 

The  AMP  module  performs  additional  operations  on  the  unsteady  aerody¬ 
namic  matrices.  These  are  separated  from  PFAERO  because  the  PFAERC  operations 
are  purely  geometrical  while  the  AMP  operations  are  a  function  of  the  particu¬ 
lar  Mach  numbers  and  reduced  frequencies  requested  in  the  Bulk  Data.  The  user 
may,  therefore,  choose  to  perform  PFAERO  in  an  initial  run  and  AMP  in  subse¬ 
quent  restart  runs. 

C. 3  OPTIMIZATION  PHASE 

LINE  2.29.  This  IF  test  checks  for  the  existence  of  any  optimization 


boundary  conditions  in  the  Solution  Control.  If  none  are  present,  control 
jumps  to  the  start  of  the  ANALYSIS  phase  at  Line  1040. 


LINES  230  TO  237.  Initialize  "constants"  that  are  used  in  the 
optimization  phase.  Of  particular  importance  to  Math  Programming  methods  is 
MOVLIM,  which  specifies  the  maximum  move  in  a  single  iteration.  ALPHA  plays 
the  same  role  for  Fully  Stressed  Design  (FSD)  and  MAXFSD  specifies  the  maximum 
number  of  FSD  cycles  that  are  performed  before  reverting  to  Math  Programming. 
MAXITER  and  CONVRGLIM  control  the  maximum  number  of  all  iterations  and  set  the 
percent  change  global  convergence  criteria,  respectively,  which  are  applicable 
to  both  optimization  methods. 

C.4  DESIGN  CONVERGENCE  LOOP 

LINE  238.  Initializes  the  convergence  loop  for  the  design  iterations. 
Once  global  convergence  is  reached  (CONVERGE-2)  or  the  maximum  number  of 
iterations  has  been  performed,  control  is  passed  to  the  start  of  the  ANALYSIS 
phase  at  Line  1040. 

LINE  242 .  Increments  the  iteration  counter,  NITER. 

LINE  243.  Calls  the  thickness  constraint  evaluation  module,  TCEVAL. 
This  module  not  only  evaluates  any  thickness  constraints,  but  also  initializes 
several  entities  which  need  to  be  flushed  between  design  iterations. 

LINE  244.  Calls  the  global  matrix  assembly  module,  EMA2.  This  module 
forms  the  stiffness  and  mass  matrices  in  the  structural  set  for  the  current 
design. 

C. 5  OPTIMIZATION  PHASE  BOUNDARY  CONDITION  LOOP 

LINE  248 .  Initiates  the  analysis  boundary  condition  loop  for  the 
OPTIMIZATION  phase.  After  all  (optimization)  boundary  conditions  have  been 
completed,  control  passes  to  active  constraint  selection  and  sensitivity 
calculation  at  Line  758.  Note  that  matrices  that  are  required  for  sensitivity 
calculations  are  subscripted  BC  in  the  MAPOL  program,  e.g.,  [GSUBO(BC)]. 

LINE  249  TO  252.  Call  the  BOUND  and  BDCASE  modules  which  determine 
the  nature  of  the  current  boundary  condition.  Parameters  are  computed  and 
passed  to  the  MAPOL  sequence  defining  the  disciplines  and  matrix  reductions  to 
be  performed.  The  parameters  have  the  following  definitions: 
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NMPC,  NSPC,  The  number  of  dependent  degrees  of  freedom  in  each 

NOMIT,  NRSET  structural  set. 

NGDR  Set  to  -1  by  BOUND  if  dynamic  reduction  is  used 

in  the  current  boundary  condition. 

BLOAD  Set  to  1  if  there  are  any  static  loads  in  the 

boundary  condition. 

BMASS  Set  to  1  if  the  mass  matrix  is  required  by  any 

discipline  in  the  boundary  condition. 

BMODES  Set  to  1  if  any  discipline  in  the  boundary  condi- 


BSAERO 

tions  requires  a  normal  modes  analysis. 

Set  to  1  if  there  are  any  static  aeroelastic 

QDP 

analyses  in  the  current  boundary  condition. 

Dynamic  pressure  of  the  SAERO  subcase(s). 

MINDEX 

Index  for  the  appropriate  steady  aerodynamic 

SYM 

matrices 

Symmetry  flag  for  SAERO; 

TRMTYP 

-  1  if  symmetric 

-  2  if  antisymmetric. 

Type  of  trim  for  any  SAERO  disciplines; 

BFLUTR 

-  0  if  no  trim 

-  1  if  lift  only  trim 

-  2  if  lift/pitching  moment  trim 

Set  to  1  if  any  flutter  analyses  in  the  current 

BDYN 

boundary  condition. 

Set  to  1  if  any  dynamic  response  disciplines 

BDTR,  BMTR 

(Except  BLAST) . 

Set  to  1  if  any  (D)irect  or  (M)odal  (TR)ansient 

BDFR,  BMFR 

response  analyses,  respectively. 

Set  to  1  if  any  (D)irect  or  (M)odal  (FR)equency 

BGUST 

response  analyses,  respectively. 

Set  to  1  if  any  GUST  options  are  selected  in  the 

BBLAST 

current  boundary  condition. 

Set  to  1  if  any  BLAST  analyses  are  in  the  current 

boundary  condition. 

Note  that  all  subsequent  operations  within  the  analysis  boundary  condition 
loop  will  be  directed  by  these  flags. 

LINE  253.  Calls  the  GTLOAD  module  to  obtain  the  applied  static  loads 
representing  the  current  design  from  the  design  load  sensitivities  and  simple 
loads  formed  in  LODGEN. 

LINES  254  TO  262.  Equivalence  the  proper  aerodynamic  influence 
coefficient  matrix  for  steady  aeroelastic  analyses  to  the  generic  [AIC] 
matrix. 

LINES  266  TO  292.  This  program  block  performs  the  required  matrix 
reductions  for  Multipoint  Constraints  for  all  matrices  that  must  be  reduced, 
as  directed  by  the  BOUND  and  BDCASE  flags.  These  can  include  the  stiffness 
matrix  [KGG] ,  mass  matrix  [MGG] ,  the  static  loads  matrix  [PG],  SAERO  splining 
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matrices  [GTKG]  and  [GSTKG] ,  and  the  unsteady  aerodynamic  splining  matrix 
(UGTKG] .  If  no  reductions  are  required,  the  n-set  matrices  are  equivalenced 
to  the  g-set  matrices.  The  program  block  begins  with  a  NULLMAT  call  which 
breaks  matrix  equivalences  set  in  previous  boundary  conditions. 

LINES  293  TO  320.  This  program  block  performs  the  required  matrix 
reductions  for  Single  Point  Constraints  for  all  matrices  that  must  be  reduced 
as  directed  by  the  BOUND  and  BDCASE  flags.  These  can  include  the  stiffness 
matrix  [KNN],  mass  matrix  [MNN] ,  the  static  loads  matrix  [PN],  SAERO  splining 
matrices  [GTKN]  and  [GSTKN] ,  and  the  unsteady  aerodynamic  splining  matrix 
[UGTKN] .  If  no  reductions  are  required,  the  f-set  matrices  are  equivalenced 
to  the  n-set  matrices.  The  program  block  beings  with  a  NULLMAT  call  which 
breaks  matrix  equivalences  set  in  previous  boundary  conditions. 

LINES  324  TO  331.  This  program  block  transforms  the  steady  aerodynam¬ 
ic  influence  coefficient  matrix  [AIC]  and  the  air  loads  matrix  [AIRFRC]  to 
the  structural  nodes  using  the  SAERO  spline  matrices.  The  stiffness  matrix 
[KAFF]  is  then  formed  which  includes  the  aeroelastic  stiffness  based  on  [AICS] 
and  QDP. 

LINES  333  TO  432 .  This  program  block  performs  the  required  matrix 
reductions  to  the  analysis  set  for  all  matrices  that  must  be  reduced  as 
directed  by  the  BOUND  and  BDCASE  flags.  These  can  include  the  stiffness 
matrix  [KFF] ,  mass  matrix  [MFF] ,  the  static  loads  matrix  [PF] ,  and  the  un¬ 
steady  aerodynamic  splining  matrix  [UGTKF].  There  are  three  possible  paths 
through  this  block  of  MAPOL  code: 

GENERAL  DYNAMIC  REDUCTION  (LINES  339  TO  372) 

The  modules  GDR1,  GDR2,  GDR3  and  GDR4  are  called  to  compute  the 
necessary  transformation  matrix  (GSUBO] .  This  matrix  is  then  used  to 
perform  the  matrix  reductions. 

STATIC  REDUCTION  (LINES  374  TO  418) 

There  are  two  subpaths  through  this  block  depending  on  whether 
the  stiffness  matrix  is  symmetric  or  asymmetric  (which  is  the  case  for 
SAERO  disciplines) . 
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ASYMMETRIC  STATIC  REDUCTION  (LINES  379  TO  398) 


This  block  of  code  is  used  only  for  SAERO  disciplines  and 
assumes  that  there  are  support  degrees  of  freedom  (as  is  required 
for  SAERO  analyses) .  Lines  379  to  385  perform  some  operations  on 
the  symmetric  stiffness  matrix  to  ensure  that  the  quantities 
needed  to  compute  the  [D]  matrix  for  later  support  set  reduction 
are  available.  Since  the  [ D ]  matrix  is  design  invariant,  it  is 
only  computed  on  the  first  iteration.  Lines  386  to  388  reduce 
the  asymmetric  stiffness  matrix  to  the  analysis  set.  Note  that 
the  off  diagonal  partition  [KOA] ,  the  asymmetric  decomposed 
stiffness  matrices  [KOOU]  and  [KOOL]  and  the  air  loads  on  the 
omitted  degrees  of  freedom  [POARO]  are  output  from  FREDUCE  for 
use  in  the  recovery  and  design  sensitivity  operations.  Lines  392 
to  398  reduce  the  mass  matrix  to  the  analysis  set.  Note  that  the 
[IFM]  matrix  is  computed  for  use  in  the  support  set  reduction  and 
sensitivity  operations. 

SYMMETRIC  STATIC  REDUCTION  (LINES  400  TO  418) 

This  block  of  code  is  used  for  all  disciplines  other  than 
SAERO  using  static  reduction.  Lines  400  to  401  reduce  the 
symmetric  stiffness  matrix  to  the  analysis  set.  Note  that  the 
symmetric  decomposed  stiffness  matrices  [KOOINV]  and  the  static 
loads  on  the  omitted  degrees  of  freedom  [PO]  are  output  from 
FREDUCE  for  use  in  the  recovery  and  design  sensitivity  opera¬ 
tions.  Lines  405  to  411  reduce  the  mass  matrix  to  the  analysis 
set.  Note  that  if  there  are  also  support  degrees  o*  freedom,  the 
[IFM]  matrix  is  computed  for  use  in  the  support  set  reduction  and 
sensitivity  operations. 

Lines  413  to  418  reduce  the  unsteady  aerodynamic  spline 
matrices  to  the  analysis  set.  The  roundabout  order  of  operations 
is  dictated  by  efficiency  considerations  for  the  MPYAD  operation. 

NO  REDUCTION  (LINES  423  TO  431) 

If  no  reductions  are  required,  the  a-set  matrices  are 
equivalenced  to  the  f-set  matrices.  The  program  block  begins  with  a 
NULLMAT  call  which  breaks  matrix  equivalences  set  in  previous  boundary 
conditions . 
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LINES  434  TO  527.  This  program  block  performs  four  functions:  (1) 
support  set  reduction  of  the  analysis  set  matrices;  (2)  static  solution 
(either  SAERO  or  STATICS);  (3)  normal  modes  analysis;  and  (4)  recovery  of 
displacements  and  accelerations  to  the  analysis  set. 

SUPPORT  SET  REDUCTION  (LINES  438  TO  507) 

Lines  439  to  441  compute  the  design  invariant  [D]  matrix  on  the 
first  iteration.  On  subsequent  iterations,  Lines  444  to  445  decompose 
the  1-set  stiffness  matrix  if  static  loads  are  present  in  the  boundary 
condition  (note  that  [KLLINV]  is  not  needed  for  other  disciplines 
after  the  [D]  matrix  has  been  computed).  Lines  451  to  456  compute  the 
reduced  mass  matrix  [MRR]  and  other  matrices  needed  for  inertia  relief 
computations:  [IFR] ,  [R22] ,  and  [R21]. 

Lines  461  to  481  perform  the  steady  aeroelastic  analyses  in  the 
current  boundary  condition.  Lines  476  to  477  call  the  SAERO  module 
which  performs  the  trim  calculation  and  evaluates  aeroelastic  effec¬ 
tiveness  constraints.  The  matrix  [DELTA]  contains  the  vector  of  trim 
parameters  on  output.  Note  that  the  trimmed  omitted  loads  [PO]  are 
computed  from  the  [POARO]  and  [DELTA]  matrices.  The  displacements  and 
accelerations  are  recovered  to  the  analysis  set  in  Lines  478  to  480. 

Lines  488  to  502  perform  static  analysis  with  inertia  relief. 
The  INERTIA  module  is  called  on  Line  497  to  compute  the  accelerations 
on  the  support  points  [AR] .  The  displacements  and  accelerations  are 
then  recovered  to  the  analysis  set  in  Lines  498  to  501. 

Lines  504  to  505  perform  real  eigenvalue  extraction  including 
rigid  body  modes.  The  eigenvectors  are  output  in  the  [PHIA]  matrix 
and  the  LAMBDA  relation  contains  the  eigenvalue  extraction  data.  Also 
output  are  the  generalized  mass  matrix,  [Mil],  and  the  number  of 
extracted  eigenvectors,  HSIZE.  Line  506  calls  the  frequency  con¬ 
straint  evaluation  module. 

NO  SUPPORT  SET  REDUCTION  (LINES  512  TO  527) 

In  this  case,  all  the  computations  are  performed  in  the  analysis 
set.  Lines  513  to  514  solve  for  displacements  due  to  static  applied 
loads.  Lines  516  to  522  represent  a  block  of  code  needed  for  the 
currently  nonfunctional  capability  to  perform  static  aeroelastic 
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analyses  with  input  trim  parameters.  Lines  524  to  525  perform  real 
eigenvalue  extraction  without  rigid  body  modes  and  frequency  con¬ 
straint  evaluation,  respectively.  The  eigenvectors  are  output  in  the 
[PHIA]  matrix  and  the  LAMBDA  relation  contains  the  eigenvalue  extrac¬ 
tion  data.  Also  output  are  the  generalized  mass  matrix,  [Mil],  and 
the  number  of  extracted  eigenvectors,  HSIZE. 

LINES  532  TO  550.  This  program  block  performs  the  requested  dynamic 
response  disciplines  except  for  BLAST.  Note  that  these  analyses  are  included 
in  the  OPTIMIZE  phase  only  for  completeness:  they  do  not  generate  any  design 
constraints . 

Lines  533  to  534  call  the  QHHLGEN  module  to  perform  the  design  depend¬ 
ent  modal  reduction  of  the  unsteady  aerodynamic  matrices  for  FLUTTER  and  GUST 
analyses  to  the  dynamic  set  (including  extra  point  degrees  of  freedom). 
Outputs  are  the  [PHIKH]  transformation  matrix  of  normal  modes  at  aerodynamic 
boxes,  the  [QHHL]  matrix  list  for  flutter  and  the  [QHJL]  matrix  list  for  gust. 

Lines  535  to  539  generate  the  stiffness,  mass  and  damping  matrices  in 
the  dynamic  set  (including  extra  point  degrees  of  freedom)  from  DMA  and  the 
applied  loads  at  time  or  frequency  steps  from  DYNLOAD .  [PDT]  contains  the 
direct  or  modal  applied  loads  at  time  steps  and  [PDF]  the  direct  or  modal 
applied  loads  at  frequency  steps. 

Lines  540  to  541  perform  modal  flutter  analysis  using  the  [KHHF] 
stiffness  matrix,  and  the  [MHH]  generalized  mass  matrix  from  DMA  and  [QHHL] 
from  QHHLGEN.  The  applied  flutter  constraints  are  also  evaluated  in  this 
module . 

Lines  543  to  549  perform  any  TRANSIENT  or  FREQUENCY  response  analyses 
using  the  matrices  generated  in  DMA  and  DYNLOAD.  The  outputs  are  either 
modal,  [Uxxxxl],  or  physical,  [UxxxxA] ,  and  extra  point  [UxxxxE] 
displacements,  velocities  and  accelerations.  If  modal  analyses  were  per¬ 
formed,  the  physical  set  responses  are  computed  in  Lines  547  to  548. 

LINES  552  TO  578 

This  program  block  performs  BLAST  analyses.  Note  that  these  analyses 
are  included  in  the  OPTIMIZE  phase  only  for  completeness:  they  do  not  gener¬ 
ate  any  design  constraints.  The  BLASTFIT  module  converts  the  unsteady  aerody¬ 
namics  matrices  from  the  frequency  domain  to  the  time  domain  and  also  provides 
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a  number  of  matrices  that  are  used  in  setting  up  a  trim  analysis.  Lines  555 
through  557  replace  the  rigid  body  modes  calculated  by  REIG  with  the  physical 
modes  contained  in  the  [D]  matrix  and  Lines  558  through  562  set  up  generalized 
matrice  (i.e.,  mass,  stiffness,  and  aerodynamic).  The  BLASTRIM  module  at  Line 
573  performs  a  trim  analysis  prior  to  the  blast  encounter  to  set  up  initial 
conditions.  The  BLASTDRV  module  then  calculates  the  aircraft  response  as  a 
function  of  time.  The  outputs  are  the  modal  displacements,  velocities  and 
accelerations  at  the  requested  time  steps  in  the  matrix  [UBLASTI]. 

LINES  582  TO  644 .  This  program  block  performs  the  required  matrix 
recovery  from  the  analysis  set  (a -set)  to  the  free  degrees  of  freedom  (f-set) 
for  all  matrices  that  must  be  recovered  as  directed  by  the  BOUND  and  BDCASE 
flags.  These  can  include  the  statics  displacement  matrix  [UF] ,  the  accelera¬ 
tion  matrix  [AF] ,  the  eigenvectors  [PHIF]  and  the  transient  and  frequency 
physical  response  matrices  [UTRANF]  and  [UFREQF] .  There  are  three  possible 
paths  through  this  block  of  MAPOL  code: 

RECOVERY  WITH  GENERAL  DYNAMIC  REDUCTION  (LINES  587  TO  597) 

The  [GSUBO]  transformation  matrix  computed  during  matrix  reduc¬ 
tion  is  used  to  recover  the  response  quantities  at  the  free  degrees  of 
freedom. 

RECOVERY  WITH  STATIC  REDUCTION  (LINES  603  TO  627) 

Like  the  corresponding  reduction,  there  are  two  recovery  paths 
depending  on  the  symmetry  of  the  stiffness  matrix.  Lines  604  to  607 
recover  the  displacements  and  accelerations  using  the  symmetric 
[KOOINV]  and  [GSUBO]  matrices  computed  in  the  symmetric  reduction 
path.  Lines  610  to  614  recover  the  displacements  and  accelerations 
using  the  asymmetric  decomposed  omitted  stiffness  partitions  [KOOU] 
and  [KOOL]  and  [GASUBO]  computed  in  the  asymmetric  path.  Lines  616  to 
617  perform  recovery  operations  for  normal  modes,  transient  response 
and  frequency  response  disciplines,  all  of  which  require  that  symmet¬ 
ric  stiffness  reduction  was  performed. 

RECOVERY  WITH  NO  REDUCTIONS  (LINES  423  TO  431) 

If  no  reductions  were  applied,  the  f-set  matrices  are 
equivalenced  to  the  a-set  matrices.  The  program  block  begins  with  a 
NULLKAT  call  which  breaks  matrix  equivalences  set  in  previous  boundary 
conditions . 
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LINES  646  TO  682.  This  program  block  performs  the  required  matrix 
recovery  from  the  free  degrees  of  freedom  (f-set)  to  the  independent  set  (n- 
set)  for  all  matrices  that  must  be  recovered  as  directed  by  the  BOUND  and  I 

BDCASE  flags.  These  can  include  the  statics  displacement  matrix  [UN],  the 
acceleration  matrix  [AN],  the  eigenvectors  [PHIN]  and  the  transient  and 
frequency  physical  response  matrices  [UTRANN]  and  [UFREQN] .  If  no  reductions 
were  applied,  the  n-set  matrices  are  equivalenced  to  the  f-set  matrices.  The  I 

program  block  begins  with  a  NULLMAT  call  which  breaks  matrix  equivalences  set 
in  previous  boundary  conditions. 

LINES  684  TO  732.  This  program  block  performs  the  required  matrix 
recovery  from  the  independent  set  (n-set)  to  the  global  structural  set  (g-set) 
for  all  matrices  that  must  be  recovered  as  directed  by  the  BOUND  and  BDCASE 
flags.  These  can  include  the  statics  displacement  matrix  [UG] ,  the  accelera¬ 
tion  matrix  [AG],  the  eigenvectors  [PHIG]  and  the  transient  and  frequency 
physical  response  matrices  [UTRANG]  and  [FREQG] .  If  no  reductions  were 
applied,  the  g-set  matrices  are  equivalenced  to  the  n-set  matrices.  The 
program  block  begins  with  a  NULLMAT  call  which  breaks  matrix  equivalences  set 
in  previous  boundary  conditions. 

LINE  736.  The  modal  blast  responses  are  recovered  to  the  physical 

set . 

LINES  740  TO  742.  Call  the  DCEVAL  module  to  evaluate  any  displacement 
constraints  that  were  applied  to  any  of  the  STATICS  or  SAERO  subcases.  If 
either  STATICS  or  SAERO  disciplines  exist,  the  SCEVAL  module  is  called  to 
evaluate  applied  stress  and/or  strain  constraints.  Note  that  the  STATICS  and 
SAERO  disciplines  are  mutually  exclusive  within  one  boundary  condition. 

LINES  746  TO  753.  This  program  block  handles  output  requests  not 
handled  directly  within  the  analysis  modules.  The  OFPLOAD  module  satisfies 
applied  load  output  requests  and  the  OFPDISP  module  satisfies  displacement, 
velocity,  acceleration  and  real  eigenvalue  (ROOTS)  output  requests.  The  EDR 
module  computes  requested  element  response  quantities  (e.g.,  stress  and 
strain)  and  the  computed  quantities  are  printed  in  OFPEDR. 

LINE  754.  This  statement  marks  the  end  of  the  analysis  boundary 
condition  loop  of  the  optimization  phase  of  the  standard  MAPOL  sequence. 
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C. 6  ACTIVE  CONSTRAINT  SELECTION 

LINES  758  TO  761.  Set  the  constraints  screening  parameters  NRFAC  and 
EPS  and  call  the  ACTCON  module  which  selects  the  constraints  to  be  retained  in 
the  Math  Programming  optimization  path.  ACTCON  also  checks  on  the  conver¬ 
gence  of  the  actual  design  problem  if  the  approximate  problem  was  designated 
as  converged.  Final  convergence  requires  that  the  maximum  constraint  value 
lie  between  bounds  specified  by  the  CTL  and  CTLMIN  parameters. 

LINE  763 .  This  IF  block  checks  to  see  if  global  convergence  or  the 
maximum  number  of  iterations  has  been  reached.  If  so  (CONVERGE  -  2  or  NITER  > 
MAXI TER ) ,  the  optimization  phase  is  complete  and  control  jumps  to  the  start  of 
the  analysis  phase  at  Line  1040.  The  MAPOL  program  is  set  up  in  this  way  to 
ensure  that  the  last  analysis  performed  in  the  optimization  phase  represents 
the  converged  design.  Sensitivity  analysis  is  not  performed  following  global 
convergence . 

LINES  767  TO  768.  Call  the  FSD  module  to  perform  Fully  Stressed 
Design  optimization.  If  no  FSD  was  selected  in  the  Solution  Control  packet  or 
if  the  number  of  iterations  exceeds  the  MAXFSD  parameter,  the  FSDFLG  is  set 
to  zero  to  enable  Math  Programming  to  occur.  A  nonzero  FSDFLG  is  returned  if 
the  FSD  module  performed  a  redesign  based  on  the  applied  stress  constraints. 

LINE  770.  The  FSDFLG  parameter  output  from  the  FSD  module  is  checked. 
If  it  is  zero,  Math  Programming  is  selected  and  the  sensitivity  portion  of  the 
optimization  phase  is  entered.  If  nonzero,  control  passes  to  the  top  of  the 
optimization  phase  at  Line  229. 

C. 7  SENSITIVITY  EVALUATION  FOR  MATH  PROGRAMMING 

LINE  776.  Calls  the  MAKDFV  module  to  evaluate  the  sensitivities  of 
boundary  condition  independent  constraints  that  are  explicit  functions  of  the 
global  design  variables.  These  are  currently  limited  to  thickness  constraints 
which  are  automatically  generated  when  shape  function  design  variable  linking 
is  used.  The  sensitivities  are  stored  in  the  matrix  [AMAT] . 

LINE  782.  Initiates  the  sensitivity  boundary  condition  loop  for  the 
OPTIMIZATION  phase.  After  all  (optimization)  boundary  conditions  have  been 
completed,  control  passes  to  the  Math  Programming  optimization  module  DESIGN 
at  Line  1028 . 
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LINES  783  TO  785.  Call  the  ABOUND  module  to  determine  whether  the 

current  boundary  condition  has  active  boundary  condition  dependent  con¬ 
straints.  This  enables  ASTROS  to  avoid  expensive  sensitivity  computations  for  | 

inactive  boundary  conditions.  Parameters  are  computed  and  passed  to  the  MAPOL 
sequence  defining  the  sensitivity  evaluations  and  matrix  reductions  to  be 
performed.  The  parameters  have  the  following  definitions: 

Set  to  1  if  the  boundary  condition  contains  active 

constraints . 

The  number  of  displacement  vectors  for  which  there  are 
active  displacement  dependent  constraints.  This 
initially  includes  one  displacement  vector  for  each 
active  lift  effectiveness  constraint  and  two  vectors 
for  each  active  aileron  effectiveness  constraint.  ' 

These  pseudo  displacement  vectors  are  partitioned  out 
in  the  AEROSENS  module. 

The  number  of  active  stress  and  displacement  con¬ 
straints  . 

The  number  of  active  frequency  constraints. 

The  number  of  active  flutter  constraints. 

Type  of  trim  for  any  active  SAERO  disciplines; 

-  0  if  no  trim 

-  1  if  lift  only  trim 

-  2  if  lift/pitching  moment  trim. 

Pointer  to  appropriate  steady  aeroelastic  stability 
coefficients  for  active  effectiveness  constraints. 

The  number  of  aeroelastic  effectiveness  constraints. 

The  number  of  active  pseudo  displacement  fields  associ¬ 
ated  with  effectiveness  constraints. 

The  number  of  dependent  degrees  of  freedom  in  each 
structural  set. 

Set  to  -1  by  ABOUND  if  dynamic  reduction  is  used  in  the 
current  active  boundary  condition. 

Note  that  all  subsequent  sensitivity  operations  within  the  sensitivity  bounda¬ 
ry  condition  loop  will  be  directed  by  these  flags. 

LINE  786.  The  active  boundary  condition  flag,  ABC,  is  checked.  If 
the  boundary  condition  is  not  active  (ABC  -  0) ,  control  jumps  to  the  next 
boundary  condition  at  Line  783.  If  no  further  boundary  conditions,  control 
jumps  to  the  DESIGN  module  at  Line  1028. 

LINE  790.  The  sensitivities  of  any  active  frequency  constraints  are 
computed . 

LINES  794  TO  796.  The  sensitivities  of  any  active  flutter  constraints 
are  computed. 


ABC 

NAU 


NACSD 

ADC 

AFC 

TRMTYP 


MINDEX 

NAE 

NAUE 

NMPC ,  NS PC, 
NOMIT,  NRSET, 
NGDR 
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LINE  797.  This  IF  test  checks  for  the  existence  of  any  active  dis¬ 
placement  dependent  onstraints  (stress,  displacement  and  aeroelastic  effec¬ 
tiveness  constraints).  If  none  are  present,  control  jumps  to  the  top  of  the 
sensitivity  boundary  condition  loop  at  Line  782.  The  block  terminates  at  Line 
1019. 

LINES  801  TO  812.  This  program  block  computes  the  sensitivity  of 
active  stross/strain  and  displacement  constraints  to  the  displacements  in  the 
MAKDFU  module.  There  are  two  methods  of  st nsitivity  evaluation  provided  for 
greater  efficiency:  the  gradient  method  and  the  virtual  load  method.  The 
gradient  method  requires  that  one  forward  backward  substitution  (FBS)  be  done 
for  each  active  displacement  for  each  design  variable.  The  virtual  load 
method  requires  one  FBS  for  each  active  stress/strain  or  displacement  con¬ 
straint.  The  method  requiring  the  fewest  FBS  operations  is  used.  When  the 
gradient  method  is  used,  the  output  from  MAKDFU  is  stored  in  [DFDU] ,  other¬ 
wise,  it  is  stored  in  [DPGV] . 

LINE  817.  The  displacement  vectors  [UG]  for  the  current  active 
boundary  condition  are  partitioned  into  the  active  and  inactive  vectors  using 
the  [PGA]  partitioning  vector  computed  in  ABOUND.  The  inactive  vectors  are 
discarded,  the  active  vectors  are  placed  in  [UGA] . 

LINE  822.  The  sensitivities  of  the  active  design  dependent  loads  (if 
any)  are  computed  in  the  DDLOAD  module.  If  no  design  dependent  loads  exist, 
DDFLG  is  set  to  0,  otherwise  it  is  1.  The  sensitivities  for  all  active  load 
conditions,  including  design  invariant  subcases,  are  stored  in  the  [DPVJ] 
matrix  if  DDFLG  equals  1. 

LINE  824.  The  matrix  product  of  the  stiffness  matrix  sensitivities 
(DKVI  from  EMA1)  times  the  active  displacements  is  computed  in  the  MAKDVU 
module . 

LINES  825  TO  833.  This  program  block  computes  additional  terms  for 
inertia  relief  problems  (both  SAERO  and  STATICS) .  Line  828  computes  the 
matrix  product  of  the  mass  matrix  sensitivities  (DMVI  from  EMAl)  times  the 
active  accelerations  while  Line  830  computes  the  matrix  product  of  the  mass 
matrix  sensitivities  times  the  active  displacements.  The  matrix  DUG  is  formed 
as  the  sum  of  DKUG  and  DMAG.  If  there  are  no  support  degrees  of  freedom,  the 
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generic  DUG  matrix  is  merely  equivalenced  to  the  DKUG  matrix  from  Line  824  at 
Line  832. 


LINES  837  TO  855.  This  program  block  adds  the  loads  sensitivities  to 
the  final  [DUG]  matrix  resulting  from  MAKDVU  module  call(s).  The  result  is 
placed  in  [DPGV]  for  the  gradient  method  or  [DFDU]  for  the  virtual  load 
method. 

LINES  859  TO  867.  This  program  block  performs  the  matrix  reductions 
for  Multipoint  Constraints  for  the  [DPGV]  matrix,  as  directed  by  the  ABOUND 
flags.  For  active  steady  aeroelastic  analyses  or  statics  with  inertia  relief, 
the  [DMUG]  matrix  is  also  reduced.  If  no  reductions  are  required,  the  n-set 
matrices  are  equivalenced  to  the  g-set  matrices.  The  program  block  begins 
with  a  NULLMAT  call  which  breaks  matrix  equivalences  set  in  previous  boundary 
conditions . 

LINES  869  TO  877.  This  program  block  performs  the  matrix  reductions 
for  Single  Point  Constraints  for  the  [DPNV]  matrix,  as  directed  by  the  ABOUND 
flags.  For  active  steady  aeroelastic  analyses  or  statics  with  inertia  relief, 
the  [DMUN]  matrix  is  also  reduced.  If  no  reductions  are  required,  the  f-set 
matrices  are  equivalenced  to  the  n-set  matrices.  The  program  block  begins 
with  a  NULLMAT  call  which  breaks  matrix  equivalences  set  in  previous  boundary 
conditions . 

LINES  879  TO  908.  This  program  block  performs  the  matrix  reductions 
for  the  [DPFV]  matrix  to  the  analysis  set  as  directed  by  the  ABOUND  flags. 
For  active  steady  aeroelastic  analyses  or  statics  with  inertia  relief,  the 
[DMUF]  matrix  is  also  reduced.  There  are  three  paths:  Lines  881  and  882 
perform  reductions  using  the  matrices  computed  in  the  analysis  boundary 
condition  loop  for  GDR;  Lines  885  to  903  perform  reductions  using  the  asymmet¬ 
ric  (886  to  894)  or  symmetric  (896  to  902)  reductions  using  the  matrices 
computed  in  the  analysis  boundary  condition  loop  for  static  condensation; 
Lines  905  to  906  perform  the  equivalences  required  in  the  case  where  no 
reductions  are  needed.  The  program  block  begins  with  a  NULLMAT  call  which 
breaks  matrix  equivalences  set  in  previous  boundary  conditions. 
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LINES  910  TO  949.  This  program  block  performs  four  functions:  (1) 
support  set  reduction  of  the  analysis  set  matrices;  (2)  aeroelastic  effective* 
ness  constraint  sensitivity  calculations;  (3)  displacement  sensitivity  evalu¬ 
ation  either  with  or  without  inertia  relief;  and  (4)  recovery  of  displacement 
sensitivities  to  the  analysis  set. 

SUPPORT  SET  REDUCTION/EFFECTIVENESS  SENSITIVITIES  (LINES  911  TO  943) 

Lines  911  to  915  compute  matrices  needed  for  inertia  relief 
computations:  [DP]  and  [DRHS] . 

Lines  920  to  932  perform  the  steady  aeroelastic  sensitivity 
evaluations.  AEROSENS  computes  the  actual  sensitivities  for 
aeroelastic  effectiveness  constraints  and  the  displacement  and  trim 
parameter  sensitivities  for  stress/strain  and  displacement  constraints 
associated  with  SAERO  analyses  in  the  current  active  boundary  condi¬ 
tion. 

Lines  937  to  942  perform  the  sensitivity  analysis  for  static 
analyses  with  inertia  relief. 

NO  SUPPORT  SET  REDUCTION  (LINE  948) 

In  this  case,  all  the  computations  are  performed  in  the  analysis 
set.  Line  948  performs  the  sensitivity  computations  if  no  support  set 
reduction  is  required. 

LINE  958.  An  additional  check  is  made  on  the  NAU  parameter  which  may 
have  been  decremented  by  AEROSENS  due  to  the  presence  of  pseudo  displacements 
for  aeroelastic  effectiveness  sensitivity  calculations.  If  no  real  displace¬ 
ment  fields  are  left,  control  jumps  to  the  next  boundary  condition  at  Line 
782.  The  IF  block  terminates  at  Line  1018.  If  any  active  strength  con¬ 
straints  remain,  the  recovery  phase  of  the  sensitivity  boundary  condition  loop 
is  entered. 

LINES  962  TO  988.  This  program  block  performs  the  required  matrix 
recovery  from  the  analysis  set  (a-set)  to  the  free  degrees  of  freedom  (f-set) 
for  the  [DUFV]  matrix  as  directed  by  the  ABOUND  flags.  There  are  three 
possible  paths  through  this  block  of  MAPOL  code: 
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RECOVERY  WITH  GENERAL  DYNAMIC  REDUCTION  (LINE  964) 


The  [GSUBO]  transformation  matrix  computed  during  matrix  reduc¬ 
tion  is  used  to  recover  the  response  quantities  at  the  free  degrees  of 
freedom. 

RECOVERY  WITH  STATIC  REDUCTION  (LINES  966  TO  984) 

Like  the  corresponding  reduction,  there  are  two  recovery  paths 
depending  on  the  symmetry  of  the  stiffness  matrix.  First,  Lines  969 
and  971  account  for  aeroelastic  or  static  inertia  relief  effects, 
respectively.  Then  the  sensitivities  of  omitted  displacements  to 
omitted  loads  are  computed  in  Lines  977  to  979  or  Lines  981  to  982  for 
SAERO  and  other  disciplines,  respectively.  Line  984  then  performs  the 
merge  operation  to  obtain  the  corrected  analysis  set  displacement 
sensitivities . 

RECOVERY  WITH  NO  REDUCTIONS  (LINE  986) 

If  no  reductions  were  applied,  the  f-set  matrices  are 
equivalenced  to  the  a-set  matrices.  The  program  block  begins  with  a 
NULLMAT  call  which  breaks  matrix  equivalences  set  in  previous  active 
boundary  conditions. 

LINES  992  TO  996.  This  program  block  performs  the  matrix  reductions 
for  Multipoint  constraints  for  the  left  hand  side  matrix  for  the  final  sensi¬ 
tivity  evaluation.  This  is  the  matrix  stored  in  [DFDUN] .  If  no  reductions 
are  required,  the  n-set  matrices  are  equivalenced  to  the  g-set  matrices. 

LINES  998  TO  1002.  This  program  block  performs  the  matrix  reductions 
for  Single  Point  Constraints  for  the  left  hand  side  matrix  for  the  final 
sensitivity  evaluation.  This  is  the  matrix  stored  in  [DFDUF] .  If  no  reduc¬ 
tions  are  required,  the  f-set  matrices  are  equivalenced  to  the  n-set  matrices. 

LINES  1006  TO  1016.  Perform  the  final  sensitivity  computations  in 
which  the  design  sensitivities  for  all  active  strength  constraints  are  com¬ 
puted.  Separate  paths  are  provided  for  the  virtual  load  and  gradient  methods. 
Both  paths  use  the  MKAMAT  module  since  identical  matrix  operations  are 
performed;  albeit  with  different  matrices.  The  resultant  sensitivities  are 
appended  to  the  [AMAT]  matrix. 


LINE  1021.  This  statement  marks  the  end  of  the  sensitivity  boundary 
condition  loop  of  the  optimization  phase  of  the  standard  MAPOL  sequence.  This 
loop  began  at  Line  782. 

LINE  1028.  Calls  the  DESIGN  module  to  perform  automated  redesign 
based  on  the  constraint  sensitivities  in  matrix  [AMAT] ,  the  current  active 
constraints  in  the  CONST  relation  and  the  objective  function  gradient  and  the 
design  variables  in  the  GLBDES  relation.  The  updated  design  variables  are 
placed  in  GLBDES  upon  completion  of  the  module. 

LINE  1033 .  This  statement  marks  the  end  of  the  design  convergence 
loop  that  started  at  Line  238. 

LINE  1034.  This  statement  marks  the  end  of  the  optimization  phase  of 
the  standard  sequence  that  started  at  Line  229. 

C.8  FINAL  ANALYSIS  PHASE 

LINE  1040.  This  IF  test  checks  the  existence  of  any  analysis  boundary 
conditions  in  the  Solution  Control.  If  none  are  present,  control  jumps  to  the 
end  of  the  standard  sequence  at  Line  1532. 

LINE  1044.  Initializes  the  constant  "-1"  used  in  the  analysis  phase. 

LINE  1045.  Calls  the  global  matrix  assembly  module,  EMA2.  This 
module  forms  the  stiffness  and  mass  matrices  in  the  structural  set  for  the 
current  design.  Note  that  the  resultant  matrices  always  represent  the  model 
defined  by  the  current  design  variable  values. 


C.9  ANALYSIS  PHASE  BOUNDARY  CONDITION  LOOP 

LINE  1046.  Initiates  the  analysis  boundary  condition  loop  for  the 
ANALYSIS  phase.  After  all  analysis  boundary  conditions  have  been  completed, 
execution  will  pass  to  termination  at  Line  1532.  The  loop  terminates  at  Line 
1531. 

LINES  1047  TO  1050.  Call  the  BOUND  and  BDCASE  modules  which  determine 
the  nature  of  the  current  boundary  condition.  Parameters  are  computed  and 
passed  to  the  MAPOL  sequence  defining  the  disciplines  and  matrix  reductions  to 
be  performed.  The  parameters  have  the  following  definitions: 


NMPC.NSPC, 
NOMIT,  NRSET 
NGDR 

BLOAD 

BMASS 

BMODES 

BSAERO 

QDP 

MINDEX 

SYM 

TRMTYP 

BFLUTR 

BDYN 

BDTR,  BMTR 
BDFR,  BMFR 
BGUST 
BBLAST 


The  number  of  dependent  degrees  of  freedom  in  each 
structural  set. 

Set  to  -1  by  BOUND  if  dynamic  reduction  is  used  in  the 
current  boundary  condition. 

Set  to  1  if  there  are  any  static  loads  in  the  boundary 
condition. 

Set  to  1  if  the  mass  matrix  is  required  by  any  disci¬ 
pline  in  the  boundary  condition. 

Set  to  1  if  any  discipline  in  the  boundary  condition 
requires  a  normal  modes  analysis. 

Set  to  1  if  there  are  any  static  aeroelastic  analyses 
in  the  current  boundary  condition. 

Dynamic  pressure  of  the  SAERO  subcase(s). 

Index  for  the  appropriate  steady  aerodynamic  matrices. 
Symmetry  flag  for  SAERO; 

-  1  if  symmetric 

-  2  if  antisymmetric. 

Type  of  trim  for  any  SAERO  disciplines; 

-  0  if  no  trim 

-  1  if  lift  only  trim 

-  2  if  lift/pitching  moment  trim. 

Set  to  1  if  any  flutter  analyses  in  the  current  bounda¬ 
ry  condition. 

Set  to  1  if  any  dynamic  response  disciplines  (except 
BLAST) . 

Set  to  1  if  any  (D)irect  or  (M)odal  (TR)ansient  rc 

sponse  analyses,  respectively. 

Set  to  1  if  any  (D)irect  or  (M)odal  (FR)equency  re¬ 

sponse  analyses,  respectively. 

Set  to  1  if  any  GUST  options  are  selected  in  the 

current  boundary  condition. 

Set  to  1  if  any  BLAST  analyses  are  in  the  current 

boundary  condition. 


Note  that  all  subsequent  operations  within  the  analysis  boundary  condition 
loop  will  be  directed  by  these  flags. 

LINE  1051.  Calls  the  GTLOAD  module  to  obtain  the  applied  static  loads 
representing  the  current  design  from  the  design  load  sensitivities  and  simple 
loads  formed  in  LODGEN. 


LINES  1052  TO  1060.  Equivalence  the  proper  aerodynamic  influence 
coefficient  matrix  for  steady  aeroelastic  analyses  to  the  generic  [AIC] 
matrix. 


LINES  1064  TO  1090.  This  program  block  performs  the  required  matrix 
reductions  for  Multipoint  Constraints  for  all  matrices  that  must  be  reduced, 
as  directed  by  the  BOUND  and  BDCASE  flags.  These  can  include  the  stiffness 
matrix  [KGG],  mass  matrix  [MGG] ,  the  static  loads  matrix  [PG] ,  SAERO  splining 
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matrices  [GTKG]  and  [GSTKG],  and  the  unsteady  aerodynamic  splining  matrix 
[UGTKG].  If  no  reductions  are  required,  the  n-set  matrices  are  equivalenced 
to  the  g-set  matrices.  The  program  block  begins  with  a  NULLMAT  call  which 
breaks  matrix  equivalences  set  in  previous  boundary  conditions. 

LINES  1093  TO  1118.  This  program  block  performs  the  required  matrix 
reductions  for  Single  Point  Constraints  for  all  matrices  that  must  be  reduced, 
as  directed  by  the  BOUND  and  BDCASE  flags.  These  can  include  the  stiffness 
matrix  [KNN] ,  mass  matrix  [MNN] ,  the  static  loads  matrix  [PN],  SAERO  splining 
matrices  [GTKN]  and  [GSTKN] ,  and  the  unsteady  aerodynamic  splining  matrix 
[UGTKN].  If  no  reductions  are  required,  the  f-set  matrices  are  equivalenced 
to  the  n-set  matrices.  The  program  block  begins  with  a  NULLTVT  call  which 
breaks  matrix  equivalences  set  in  previous  boundary  conditions. 

LINES  1122  TO  1127.  This  program  block  transforms  the  steady  aerody¬ 
namic  influence  coefficient  matrix  [AIC]  and  the  air  loads  matrix  [AIRFRC]  to 
the  structural  nodes  using  the  SAERO  spline  matrices.  The  stiffness  matrix 
[KAFF]  is  then  formed  which  includes  the  aeroelastic  stiffness  based  on  [AICS] 
and  QDP. 

LINES  1129  TO  1226.  This  program  block  performs  the  required  matrix 
reductions  to  the  analysis  set  for  all  matrices  that  must  be  reduced  as 
directed  by  the  BOUND  and  BDCASE  flags.  These  can  include  the  stiffness 
matrix  [KFF] ,  mass  matrix  [MFF] ,  the  static  loads  matrix  [PF],  and  the  un¬ 
steady  aerodynamic  splining  matrix  [UGTKF] .  There  are  three  possible  paths 
through  this  block  of  MAPOL  code: 

GENERAL  DYNAMIC  REDUCTION  (LINES  1130  TO  1166) 

The  modules  GDR1,  GDR2,  GDR3,  and  GDR4  are  called  to  compute  the 
necessary  transformation  matrix  [GSUBO],  This  matrix  is  then  used  to 
perform  the  matrix  reductions. 

STATIC  REDUCTION  (LINES  1168  TO  1212) 

There  are  two  subpaths  through  this  block  depending  on  whether 
the  stiffness  matrix  is  symmetric  or  asymmetric  (which  is  the  case  for 
SAERO  disciplines). 
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ASYMMETRIC  STATIC  REDUCTION  (LINES  1172  TO  1192) 

This  block  of  code  is  used  only  for  SAERO  disciplines  and 
assumes  that  there  are  support  degrees  of  freedom  (as  is  required 
for  SAERO  analyses).  Lines  1177  to  1178  perform  some  operations 
on  the  symmetric  stiffness  matrix  to  ensure  that  the  quantities 
needed  to  compute  the  [D]  matrix  for  later  support  set  reduction 
are  available.  Lines  1180  to  1182  reduce  the  asymmetric  stiff¬ 
ness  matrix  to  the  analysis  set.  Note  that  the  off  diagonal 
partition  [KOA] ,  the  asymmetric  decomposed  stiffness  matrices 
[KOOU]  and  [KOOL]  and  the  air  loads  on  the  omitted  degrees  of 
freedom  [POARO]  are  output  from  FREDUCE  for  use  in  the  recovery 
and  design  sensitivity  operations.  Lines  1186  to  1192  reduce  the 
mass  matrix  to  the  analysis  set.  Note  that  the  IFM  matrix  is 
computed  for  use  in  the  support  set  reduction. 

SYMMETRIC  STATIC  REDUCTION  (LINES  1194  TO  1212) 


This  block  of  code  is  used  for  all  disciplines  other  than 
SAERO  using  static  reduction.  Lines  1194  to  1195  reduce  the 
symmetric  stiffness  matrix  to  the  analysis  set.  Note  that  the 
symmetric  decomposed  stiffness  matrices  [KOOINV]  and  the  static 
loads  on  the  omitted  ’agrees  of  freedom  [PO]  are  output  from 
FREDUCE  for  use  in  tht  recovery  operations.  Lines  1199  to  1205 
reduce  the  mass  matrix  to  the  analysis  set  Note  that  if  there 
are  also  support  degrees  of  freedom,  the  IFM  matrix  is  computed 
for  use  in  the  support  set  reduction  and  sensitivity  operations. 


Lines  1207  to  1212  reduce  the  unsteady  aerodynamic  spline 
matrices  to  the  analysis  set.  The  roundabout  order  of  operations 
is  dictated  by  efficiency  considerations  for  the  MPYAD  operation. 

NO  REDUCTION  (LINES  1217  TO  1224) 

If  no  reductions  are  required,  the  a-set  matrices  are 
equivalenced  to  the  f-set  matrices.  The  program  block  begins 
with  a  NULLMAT  call  which  breaks  matrix  equivalences  set  in 
previous  boundary  conditions. 

LINES  1227  TO  1309.  This  program  block  performs  four  functions:  (1) 
support  set  reduction  of  the  analysis  set  matrices,  (2)  static  solution 
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(either  SAERO  or  STATICS),  (3)  normal  modes  analysis,  and  (4)  recovery  of 
displacements  and  accelerations  to  the  analysis  set. 

SUPPORT  SET  REDUCTION  (LINES  1231  TO  1291) 

Lines  1231  to  1233  compute  the  design  invariant  [D]  matrix. 
Lines  1237  to  1242  compute  the  reduced  mass  matrix  [MRR]  and  other 
matrices  needed  for  inertia  relief  computations:  [IFR],  [R22]  and 
[R21]. 

Lines  1247  to  1268  perform  the  steady  aeroelastic  analyses  in  the 
current  boundary  condition.  Lines  1261  to  1262  call  the  SAERO  module 
which  performs  the  trim  calculation.  The  matrix  [DELTA]  contains  the 
vector  of  trim  parameters  on  output.  Note  that  the  trimmed  omitted 
loads  [PO]  are  computed  from  the  [POARO]  and  [DELTA]  matrices.  The 
displacements  and  accelerations  are  recovered  to  the  analysis  set  in 
Lines  1264  to  1266  if  there  are  displacements  and  accelerations 
computed.  Zero  degree  of  freedom  aeroelastic  analyses  will  not 
produce  any  displacement  or  acceleration  fields.  Note  that  this  is 
different  in  the  optimization  phase  where  aeroelastic  effectiveness 
constraints  generate  pseudo  displacements  for  all  trim  type  values. 

Lines  1275  to  1288  perform  static  analysis  with  inertia  relief. 
The  INERTIA  module  is  called  on  Line  1284  to  compute  the  accelerations 
on  the  support  points  [AR] .  The  displacements  and  accelerations  are 
then  recovered  to  the  analysis  set  in  Lines  1285  to  1288. 

Lines  1290  to  1291  perform  real  eigenvalue  extraction  including 

/ 

rigid  body  modes.  The  eigenvectors  are  output  in  the  [PHIA]  matrix 
and  the  LAMBDA  relation  contains  the  eigenvalue  extraction  data.  Also 
output  are  the  generalized  mass  matrix,  [Mil],  and  the  number  of 
extracted  eigenvectors,  HSIZE. 

NO  SUPPORT  SET  REDUCTION  (LINES  1296  TO  1308) 

In  this  case,  all  the  computations  are  performed  in  the  analysis 
set.  Lines  1297  to  1298  solve  for  displacements  due  to  static  applied 
loads .  Lines  1300  to  1306  represent  a  block  of  code  needed  for  the 
currently  non- functional  capability  to  perform  static  aeroelastic 
analyses  with  input  trim  parameters.  Lines  1307  to  1308  perform  real 
eigenvalue  extraction  without  rigid  body  modes  and  frequency  con- 
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straint  evaluation,  respectively.  The  eigenvectors  are  output  in  the 
[PHIA]  matrix  and  the  LAMBDA  relation  contains  the  eigenvalue  extrac¬ 
tion  data.  Also  output  are  the  generalized  mass  matrix,  [Mil],  and 
the  number  of  extracted  eigenvectors,  HSIZE. 

LINES  1314  TO  1332.  This  program  block  performs  the  requested  dynamic 
response  disciplines  except  for  BLAST.  Lines  1315  to  1316  call  the  QHHLGEN 
module  to  perform  the  modal  reduction  of  the  unsteady  aerodynamic  matrices  for 
FLUTTER  and  GUST  analyses  to  the  dynamic  set  (including  extra  point  degrees  of 
freedom).  Outputs  are  the  [PHIKH]  transformation  matrix  of  normal  modes  at 
aerodynamic  boxes,  the  [QHHL]  matrix  list  for  flutter  and  the  [QHJL]  matrix 
list  for  gust. 

Lines  1317  to  1321  generate  the  stiffness,  mass  and  damping  matrices 
in  the  dynamic  set  (including  extra  point  degrees  of  freedom)  from  DMA  and  the 
applied  loads  at  time  or  frequency  steps  from  DYNLOAD.  [PDT]  contains  the 
direct  or  modal  applied  loads  at  time  steps  and  [PDF]  the  direct  or  modal 
applied  loads  at  frequency  steps. 

Lines  1322  to  1323  performs  modal  flutter  analysis  using  the  [KHHF] 
stiffness  matrix,  and  the  [MHH]  generalized  mass  matrix  from  DMA  and  [QHHL] 
from  QHHLGEN. 

Lines  1325  to  1328  perform  any  TRANSIENT  or  FREQUENCY  response  analy¬ 
ses  using  the  matrices  generated  in  DMA  and  DYNLOAD.  The  outputs  are  either 
modal,  [Uxxxxl],  or  physical,  [UxxxxA] ,  and  extra  point  [UxxxxE] 
displacements,  velocities  and  accelerations.  If  modal  analyses  were  per¬ 
formed,  the  physical  set  responses  are  computed  in  Lines  1329  to  1330. 

LINES  1333  TO  1360.  This  program  block  performs  BLAST  analyses.  The 
BLASTFIT  module  converts  the  unsteady  aerodynamics  matrices  from  the  frequen¬ 
cy  domain  to  the  time  domain  and  also  provides  a  number  of  matrices  that  are 
used  in  setting  up  a  trim  analysis.  Lines  1137  through  1339  replace  the  rigid 
body  modes  calculated  by  REIG  with  the  physical  modes  contained  in  the  [D] 
matrix  and  Lines  1340  through  1354  set  up  generalized  matrices  (i.e.,  mass, 
stiffness,  and  aerodynamic).  The  BLASTRIM  module  at  Line  1355  performs  a  trim 
analysis  prior  to  the  blast  encounter  to  set  up  initial  conditions.  The 
BLASTDRV  module  then  calculates  the  aircraft  response  as  a  function  of  time. 
The  outputs  are  the  modal  displacements,  velocities  and  accelerations  at  the 
requested  time  steps  in  the  matrix  [UBLASTI]. 
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LINES  1364  TO  1426.  This  program  block  performs  the  required  matrix 
recovery  from  the  analysis  set  (a-set)  to  the  free  degrees  of  freedom  (f-set) 
for  all  matrices  that  must  be  recovered  as  directed  by  the  BOUND  and  BDCASE 
flags.  These  can  include  the  static  displacement  matrix  [UF] ,  the  accelera¬ 
tion  matrix  [AF] ,  the  eigenvectors  [PHIF]  and  the  transient  and  frequency 
physical  response  matrices  [UTRANF]  and  [UFREQF] .  There  are  three  possible 
paths  through  this  block  of  MAPOL  code: 

RECOVERY  WITH  GENERAL  DYNAMIC  REDUCTION  (LINES  1369  TO  1379) 

The  [GSUBO]  transformation  matrix  computed  during  matrix  reduc¬ 
tion  is  used  to  recover  the  response  quantities  at  the  free  degrees  of 
freedom. 

RECOVERY  WITH  STATIC  REDUCTION  (LINES  1381  TO  1409) 

Like  the  corresponding  reduction,  there  are  two  recovery  paths 
depending  on  the  symmetry  of  the  stiffness  matrix.  Lines  1386  to  1389 
recover  the  displacements  and  accelerations  using  the  symmetric 
[KOOINV]  and  [GSUBO]  matrices  computed  in  the  symmetric  reduction 
path.  Lines  1392  to  1396  recover  the  displacements  and  accelerations 
using  the  asymmetric  decomposed  omitted  stiffness  partition  [KOOU]  and 
[KOOL]  and  [GASUBO]  computed  in  the  asymmetric  path.  Lines  1398  to 
1409  perform  recovery  operations  for  normal  modes,  transient  response 
and  frequency  response  disciplines,  all  of  which  require  that  symmet¬ 
ric  stiffness  reduction  was  performed. 

RECOVERY  WITH  NO  REDUCTIONS  CJ.INES  1414  TO  1425) 

If  no  reductions  were  applied,  the  f-set  matrices  are 
equivalenced  to  the  a-set  matrices.  The  program  block  begins  with  a 
NULLMAT  call  which  breaks  matrix  equivalences  set  in  previous  boundary 
conditions . 


LINES  1428  TO  1464.  This  program  block  performs  the  required  matrix 
recovery  from  the  free  degrees  of  freedom  (f-set)  to  the  independent  set  (n- 
set)  for  all  matrices  that  must  be  recovered  as  directed  by  the  BOUND  and 
BDCASE  flags.  These  can  include  the  statics  displacement  matrix  [UN],  the 
acceleration  matrix  [AN],  the  eigenvectors  [PHIN]  and  the  transient  and 
frequency  physical  response  matrices  [UTRANN]  and  [UFREQN].  If  no  reductions 
were  applied,  the  n-set  matrices  are  equivalenced  to  the  f-set  matrices.  The 


program  block  begins  with  a  NULLMAT  call  which  breaks  matrix  equivalences  set 
in  previous  boundary  conditions. 

LINES  1466  TO  1514.  This  program  block  performs  the  required  matrix 
recovery  from  the  independent  set  (n-set)  to  the  global  structural  set  (g-set) 
for  all  matrices  that  must  be  recovered  as  directed  by  the  BOUND  and  BDCASE 
flags.  These  can  include  the  statics  displacement  matrix  [UG] ,  the  accelera¬ 
tion  matrix  [AG],  the  eigenvectors  [PHIG]  and  the  transient  and  frequency 
physical  response  matrices  [UTRANG]  and  [UFREQG] .  If  no  reductions  were 
applied,  the  g-set  matrices  are  equivalenced  to  the  n-set  matrices.  The 
program  block  begins  with  a  NULLMAT  call  which  breaks  matrix  equivalences  set 
in  previous  boundary  conditions. 

LINE  1518.  The  modal  blast  responses  are  recovered  to  the  physical 

set . 

LINES  1522  TO  1529.  This  program  block  handles  output  requests  not 
handled  directly  within  the  analysis  modules.  The  OFPLOAD  module  satisfies 
applied  load  output  requests  and  the  OFPDISP  module  satisfies  displacement, 
velocity,  acceleration  and  real  eigenvalue  (ROOTS)  output  requests.  The  EDR 
module  computes  requested  element  response  quantities  (e.g.,  stress  and 
strain)  and  the  computed  quantities  are  printed  in  OFPEDR. 

LINE  1530.  This  statement  marks  the  end  of  the  analysis  boundary 
condition  loop  of  the  analysis  phase  of  the  standard  MAPOL  sequence. 

LINE  1531.  This  statement  marks  the  end  of  the  analysis  phase  of  the 
standard  sequence  that  started  at  Line  1040. 

LINE  1532.  Termination  of  the  standard  MAPOL  sequence. 
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MAPOL  SOURCE  CODE  LISTING 


STAT  LEVL 


1 

2 

3 

1!$********' 

11$ 

1!$ 

EXECUTIVE  SEQUENCE  TOR  ASTROS  —  11  FEBRUARY  1988 

****$! 

$1 

$1 

4 

3.1$********’ 

****$! 

5 

1!$ 

VARIABLE  DECLARATION 

SEGMENT 

$i 

6 

J.  1$*****«  **< 

****$! 

7 

11$ 

$i 

8 

1!  INTEGER 

NEGl; 

1 

9 

1 1  INTEGER 

GSIZE , 

CONVERGE , 

NITER, 

MAX ITER, 

MAXFSD, 

1 

10 

11 

FSDFLG, 

BC, 

NDV; 

! 

11 

1  i  REAL 

CTL, 

CTLMIN, 

MOVLIM, 

CNVRGLIM, 

ALPHA; 

! 

12 

1 1 UNSTRUCT 

DCENT , 

GRIDTEMP; 

! 

13 

1 1  RELATION 

DESHIST, 

CONST, 

MPPARM, 

CONVERT, 

SAVE, 

! 

14 

ii 

MFORM, 

GRID, 

SPOINT, 

E POINT, 

SEQGP, 

1 

15 

ii 

BGPDT, 

CSTM, 

FORCE, 

FORCEl, 

MOMENT, 

1 

16 

ii 

MOMENT1, 

PLOAD, 

GRAV, 

LOAD, 

EIGR, 

! 

17 

ii 

TEMP, 

TEMPD, 

DCONDSP, 

DCONFRQ, 

DCONTHK, 

! 

18 

ii 

CORD1C, 

CORD1R, 

CORDIS, 

CORD2C, 

CORD2R, 

1 

19 

ii 

CORD2S ; 

1 

20 

n$ 

$i 

21 

1 {§********< 

$  1 

22 

n$ 

DECLARATIONS 

TOR  MODULE 

MKUSET 

$i 

23 

1 1§*  *******  i 

24 

n$ 

$i 

25 

1IUNSTRUCT 

USET; 

1 

26 

11  RELATION 

SPC, 

SPCl, 

SPCADD, 

MPC, 

MPCADD, 

1 

27 

11 

ASET, 

ASET1, 

OMIT, 

OMIT1 . 

SUPORT, 

j 

28 

11 

JSET, 

JSET1 ; 

t 

29 

11 MATRIX 

(PGMN(8) 1, 

[PNSF(8)1, 

( PFOAt  8 ) J , 

( PARL( 8)1, 

[TMNl 8)J, 

1 

30 

ii 

[ YS ( 8 ) ] ; 

! 

31 

n$ 

$! 

32 

ll$********' 

33 

n$ 

DECLARATIONS 

rOR  MODULES 

;  MAKEST  AND  EMG 

$1 

34 

11$********' 

**  *  *$1 

35 

n$ 

$1 

36 

1 1 UNSTRUCT 

DVSIZE, 

vtixd. 

PCOMPS; 

! 

37 

1 1 1  UN  STRUCT 

KELM, 

MELM, 

TELM; 

i 

38 

11  RELATION 

CQWEM1, 

QDMMlEST, 

CROD, 

CONROD, 

RODEST, 

t 

39 

11 

CSHEAR, 

SHEAREST, 

CTRMEM, 

TRMEMEST, 

CMASS1 , 

! 

40 

11 

CMASS2, 

MASSEST, 

CONM1, 

CONM1EST, 

CONM2, 

i 

41 

11 

CONM2EST, 

CHAR, 

BEAMEST, 

CQUAD4 , 

QUAD4EST, 

! 

42 

11 

ClhEXl, 

IHEX1EST, 

CIHEX2, 

IHEX2EST, 

CIHEX3, 

! 

43 

11 

IHEX3EST, 

CELAS1, 

CELAS2 

ELASEST, 

ELIST, 

! 

44 

11 

PLIST, 

DVCT, 

DESVAR, 

GLBDES , 

DESE1M, 

i 

45 

11 

LOCLVAR, 

PCOMP, 

pqdkemi. 

PROD, 

PSHEAR, 

1 

46 

11 

PTRMEM, 

PMASS, 

PELAS, 

PBAR, 

PSHELL, 

1 

47 

11 

PCOMPl, 

PCOMP2, 

PIHEX , 

MATl, 

MAT2, 

! 

48 

11 

MATS, 

MAT9, 

dconstr  ,* 

! 

49 

1 1 MATRIX 

(PTRANS); 

! 

50 

1 1 IMATRIX 

t PMINT 1 , 

[  PMAXT )  , 

ISMAT); 

! 

51 

11$ 

$i 

52 

n$******** 

53 

11$ 

DECLARATIONS 

rOR  ELEMENT  DATA  RECOVERY 

(EDR) 

$i 

54 

US"*******’ 

****$! 

55 

11$ 

$i 

56 

11  RELATION 

GRIDLIST, 

M0DELIST, 

ELEMLIST, 

FREQLIST, 

TIME  LI  ST, 

t 

57 

11 

GPFELEM, 

EOSUMMRY, 

EORAR, 

EOELAS, 

EOHEX1 , 

1 

58 

11 

EOHEX2, 

EOHEX3 , 

eoqdmmi. 

EOQUAD4 , 

EOROD, 

1 

59 

11 

EOSHEAR, 

EOTRMEM, 

GPFDATA; 

! 

60 

11  UNSTRUCT 

EODISC; 

! 

Figure  C.l  Standard  MAPOL  Sequence 
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MMOL  SOURCE  CODE  LISTING 


STAT  LEVL 


61 

1!$ 

62 

!!§********< 

63 

n$ 

DECLARATIONS 

FOR  MODULES 

EMAl,  EMA2  AND  GLOBAL 

64 

n$ 

MATRIX  PARTITION/REDUCTION 

65 

1 }$******«*< 

66 

n$ 

67 

1 IIUNSTRUCT 

DKVI, 

DMVI; 

66 

1 1 RELATION 

GMKCT, 

GMMCT; 

69 

1 (MATRIX 

]KGG], 

[KNN], 

)KFF), 

1KAA), 

[KLL1, 

70 

11 

]MGG), 

)MNN) , 

]MFF), 

)MAA], 

1MLL), 

71 

11 

JMRRBAR], 

IMLR), 

) KFS 1 , 

1KSS), 

)  KOOINV  (  6  )  ]  , 

72 

11 

]GSUBO(8)), 

[KOOL(6 ) ) , 

[ KOOU( 8 ) ] , 

]  KLLINV  ( 8  ) ) , 

) KAO( 8 )  )  , 

73 

1! 

[MRR(8)1, 

)IFM(6)), 

)IFR(8)), 

10(8)), 

(KLR), 

74 

1  ! 

J  LHS  <6)J, 

[ KLLU( 8 ) 1 , 

[ KLLL( 8 ) ) , 

,  I  MOO) , 

1MOA), 

75 

11 

[MAABAR]; 

76 

1 l MATRIX 

[TMP1], 

)TMP2); 

77 

1 1 MATRIX 

IPO) « 

)PN], 

)PF), 

)PA), 

)PL), 

76 

11 

)po). 

(PLBAR) , 

)PR]  i 

)RHS(8)), 

(UG( 8)1, 

79 

11 

)UN) , 

[UF], 

)UA), 

)UL), 

[UM), 

80 

11 

) AG ( 8 ) ) , 

[AN], 

1AF) , 

1AA), 

)AR), 

81 

li 

)  AL] , 

[UO], 

[UOO], 

( POARO( 8 ) ) ; 

82 

11$ 

1 | $ ******** 4 

84 

11$  DECLARATIONS  FOR 

SOLUTION  CONTROL 

85 

- " - 

86 

11$ 

87 

1 l INTEGER 

NUMOPTBC, 

OPSTRAT , 

NBNDCOND, 

BLOAD, 

BMASS , 

88 

li 

BMODES, 

BSAERO, 

BFLUTR, 

BDYN, 

BECtSP , 

89 

1! 

BDTR, 

BMTR, 

BDFR, 

BMFR 

BGUST, 

90 

1! 

BBLAST, 

NMPC, 

NS  PC, 

NOMI 

NRSET, 

91 

1! 

TRKTYP; 

92 

1 ! RELATION 

CASE; 

93 

n$ 

1 1$  * »**♦*•*' 

95 

11$  DECLARATIONS  FOR 

SENSITIVITY 

EVALUATION 

. 

97 

11$ 

98 

l! INTEGER 

DDF LG, 

NACSD , 

AAC, 

NAU, 

ABC, 

99 

1! 

ADC, 

AFC, 

NAE, 

NAUE; 

100 

UREAL 

EPS, 

NRFAC; 

101 

IIUNSTRUCT 

PCA, 

PAE; 

102 

1! MATRIX 

1DFDU), 

[PGA] , 

)UGA), 

]DUG) , 

)DMUG), 

103 

11 

)DPFV] , 

[DPOV], 

1DPNV), 

1 DPAV ) , 

[DUAV1 . 

104 

11 

]  DU  AD  ]  , 

[Durv], 

]AGA], 

1AMAT), 

)DKUG), 

105 

1! 

[  DPGV  1  , 

] DPLV ] , 

[DURD) , 

1DULD), 

)DULV), 

106 

1! 

) DDELDV ) , 

(DPRV), 

[ DKLV) , 

[DRHS]  , 

JDFDUF) , 

107 

1! 

) DFDUN 1 , 

)DMAfl], 

]  DMUN)  , 

[0MUT1, 

[OMUA1, 

108 

11 

)DMUO], 

[DMUL), 

IDMUR)  , 

[0MU), 

) DPI J , 

109 

1! 

I DK1 V ] ; 

110 

1 ! I MATRIX 

[GLBSIG ] , 

l DPTHVI ] , 

[ DPGRVI ] , 

[DPVJ1; 

111 

11$ 

1  |  $  ********  i 

113 

11$  AERODYNAMIC  ENTITIES 

11* . . 

115 

11$ 

116 

1 ! INTEGER 

SYM, 

MINDEX, 

NAERO; 

117 

UREAL 

OOP; 

118 

1 iUNSTRUCT 

AC1T, 

UNMK; 

$ 

$ 

$ 

$ 

'$ 

$ 


$ 

$ 

$ 

$ 

$ 


$ 

$ 

$ 

$ 

$ 


$ 

$ 

$ 

$ 

$ 


Figure  C. 1  Standard  MAPOI,  Sequence  (Continued) 
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*****  MAPOL  SOURCE 

CODE  LISTING  * 

*  *  ** 

STAT 

LEVL 

119 

11  RELATION 

AESURF, 

AIRFOIL, 

AEROS, 

AErACT, 

AXSTA, 

120 

1! 

BODY, 

SPLINEl, 

SETl, 

SET2 , 

ATTACH, 

121 

11 

TRIM, 

AERO, 

BLAST, 

CAER06 , 

PAER06 , 

122 

11 

USAGEOM, 

AECOMP, 

STABCF, 

CAEROl, 

PAEROl, 

123 

11 

CAER02, 

PAER02, 

MKAEROl, 

MKAER02, 

FLUTTER, 

124 

11 

FLFACT, 

CLAMBDA, 

DCONALE, 

DCONCLA, 

dcontlt; 

125 

1 1 MATRIX 

(AIRFRCI8 )  1 

,  (AIQ1AT(8)  ] 

[AAICMAT1 8 ) ) 

(AIC), 

(AICS ) , 

126 

11 

1KATF), 

(RAF) , 

IKAAA], 

(PAA), 

[GASUBO(8)l, 

127 

11 

(SKJ), 

( D1JK ) , 

(D2JK), 

(KARL), 

(KALL), 

128 

11 

( K21 <  8 » ) , 

(PARBAR), 

(PAL), 

[ PAR (8)), 

(K1112(8)), 

129 

11 

(DELTA) , 

(GTKG) , 

(GTKN), 

( GTKF ) , 

[ GSTKO ) , 

130 

11 

(GSTKN) , 

(GSTKF) , 

[GSKF ) , 

(U0TKG), 

(UOTKN) , 

131 

11 

[UGTKF ] , 

(UGTKA) , 

(UGTKO) , 

(UGTKAB), 

(AITD), 

132 

11 

(KARR) , 

(KALR) , 

IR22), 

(R32), 

1KU), 

133 

11 

(K12<8) ) , 

(PI), 

(R21 1 , 

(R31), 

(KL11(8) ), 

134 

11 

(KU11(8 ) ) , 

(P2); 

135 

11IHATRIX 

( AJJTL] , 

[QJJL], 

IQKKL), 

(QHHL1 8)); 

136 

11$ 

137 

U§******** 

138 

11$  DYNAMIC  RESPONSE 

DECLARATIONS 

139 

. 

140 

11$ 

141 

11  INTEGER 

HSIZE; 

142 

1 IUNSTRUCT 

TTDATA, 

ICDATA; 

143 

1 1  RELATION 

LAMBDA, 

OEIGS , 

DLONLY, 

DLOAD, 

TABLED1 , 

144 

11 

IC, 

TLOADl, 

TLOAD2, 

RLOAD1 , 

RLOAD2, 

145 

11 

TSTEP, 

VSDAMP, 

TABDHP1, 

DLAGS, 

TF, 

146 

11 

DMIG, 

GUST, 

FREQ, 

FREQl , 

FREQ2 , 

147 

11 

FFT, 

FLUTREL; 

148 

11 MATRIX 

(PHIKH) , 

(QHJL) , 

[QKJL], 

(PHIA), 

(Mil), 

149 

11 

(PHIO), 

(PHIF), 

(PHIN), 

[ PHIG( 8 ) ) , 

(KHHT) , 

150 

11 

(KKKF(8) ] ( 

(BHH), 

(MHH(8) ) , 

(POT), 

(PDF), 

151 

11 

(KDDT), 

(KDDF) , 

(BDD], 

[MDD], 

(ICMATRIX), 

152 

11 

(UTRANA), 

(UFREQA) , 

(UTRANI), 

[ UFREQI ) , 

[UFREQE] , 

153 

11 

(UTRANE) , 

(UTRANF) , 

(UFREQF ) , 

(UTRANN), 

(UFREQN), 

154 

11 

(UTRANG)  , 

(UFREQGl , 

[ FLUTMODE ) , 

(PTGLOAD), 

[PFGLOAD] ; 

155 

11$ 

156 

n$******** 

157 

11$  DECLARATIONS  TOR  GENERAL  DYNAMIC 

REDUCTION  <GDR) 

158 

. 

159 

11$ 

160 

11 INTEGER 

LKSET, 

LJSET, 

NEIV, 

GNORM, 

NGDR, 

161 

11 

GSIZEN; 

162 

UREAL 

FMAX; 

163 

1  IUNSTRUCT 

GDRUSET; 

164 

11 RELATION 

DYNRED, 

GDRBGPDT; 

165 

11 MATRIX 

(GI»GO(8)), 

(PHIOK) , 

(KOO), 

[GGOJ, 

[ KSOO ] , 

166 

11 

(KOA), 

( LSOO ) ; 

167 

11$ 

168 

U$** . 

169 

11$  BLAST  RESPONSE  DECLARATIONS 

170 

H* . 

171 

11$ 

172 

UREAL 

BQDP; 

173 

11 MATRIX 

IMPART), 

(ID2), 

(PI1IE) , 

(PHIR) , 

[PHIB], 

174 

11 

(GENM), 

(GENK), 

(GENT), 

(GENQ)  , 

[ GENQL ) , 

175 

1! 

(DTSLP)  , 

(nr), 

(ORE), 

[QEE], 

[KEQE], 

176 

11 

(LKQ), 

[UKQJ , 

(GFR), 

[GFE], 

[  BTEM) , 

177 

11 

(BLSTJA), 

(BLGTJAI, 

(BFRC), 

(MATTR), 

(MATSS), 

178 

11 

(KEE), 

[DELB], 

(DELM)  , 

(URDB) , 

(GENTA) , 

179 

11 

(DWNWSH), 

(ELAS), 

(SLPMOD) , 

[QRR], 

(UBLASTI), 

180 

11 

(UBLASTG ] ; 

Figure  C.l  Standard  MAPOL  Sequence 


(Cont inued) 
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MAPOL  SOURCE  CODE  LISTING 


STAT  LEVL 

151  1 !  $ 

152  . . . . . . . . ***** . 

153  1 ! $ 

184  1 !  $  BEGIN  MAPOL  SOLUTION  SEQUENCE 

185  1 !  $ 

186  . . . . »*.***»»»*****»»»»»**»»»»*,»» . ******* . ***** 

187  1 !  $  PREFACE  MODULES 

188  1!$*** . * . »»*»»*»»****»*»•»»»»*****»** . . . * . *»» . 

189  1 ! $ 

190  1ICALL  SOLUTION!  NUMOPTBC  ,  NBNDCOND,  OPSTRAT  ); 

191  liCALL  IFP  (  OSIZE  ); 

192  lirOR  BC  =  1  TO  NBNDCOND  DO 

193  2!  CALL  MKUSET!  BC,  GSIZE,  (YS(BC)),  (TMN(BC)  ) ,  (PGMt(BC)),  (PNSF(BC)), 

194  2!  (PFOA(BC)],  ( PARL(BC) ) ) ; 

195  2IENDDO; 

196  1 ! $ 

197  1!$  GENERATE  THE  ELEMENT  MATRICES 

198  1 ! $ 

199  1 ! CALL  MAKEST  (  NDV  ); 

200  1ICALL  EMG  (  NDV,  GSIZE  >; 

201  1 1  CALL  PFBULK  (  GSIZE,  EOSUMMRY,  EODISC,  GPFELEM  ); 

202  1 ! $ 

203  1 !  $  ASSEMBLE  THE  ELEMENT  MATRICES 

204  1!$  TO  THE  SENSITIVITY  MATRICES 

205  1 !  $ 

206  II CALL  EMA1  (  NDV,  GMKCT,  DKVI ,  GMMCT,  DMVI  ); 

207  11$ 

208  11$  GENERATE  THE  SIMPLE  LOAD  VECTORS 

209  11$  AND  LOAD  SENSITIVITIES 

210  11$ 

211  1 1  CALL  LODGEN  (  GSIZE  ); 

212  11$ 

213  11$  GENERATE  THE  AIC  MATRIX  AND  THE 

214  11$  SPLINE  TRANSFORMATION  MATRICES 

215  11$ 

216  1IMINDEX  :«  1; 

217  1INAERO  :»  2; 

218  1 1  WHILE  MINDEX  <«  NAERO  DO 

219  21  CALL  PFAERO  (  GSIZE,  [AICMAT<  MINDEX  I ) ,  [AAICMAT!  MINDEX)  ] , 

220  2!  ( AIRFRC ( MINDEX )  ) ,  MINDEX,  NAERO, 

221  21  IGTKG),  IGSTKG),  (UGTKG),  [AJJTL] ,  ID1JK),  (D2JK),  (SKJ)  ) 

222  2IENDDO; 

223  1ICALL  AMP  (  (AJJTL),  (D1JK),  (D2JK),  (SKJ),  (QKKL) ,  (QKJL)  ,  (QJJL)  )  ,* 

224  11$ 

225  . . * . 

226  1  !$  BEGIN  OPTIMIZATION  LOOP 

227  11$ . . . * . * 

228  1!$ 

229  II  IF  NUMOPTBC  )  0  THEN 

230  21  CONVERGE  :=  0; 

231  2!  NITER  :=  0; 

232  2!  MAXITER  :=  15; 

233  2!  MOVLIM  :=»  2.0; 

234  2!  MAXFSD  :=  3; 

235  2!  ALPHA  :=  0.90; 

236  2!  CNVRGLIM  :=  0.50; 

237  21  NEG1  :=  -1; 

238  2!  WHILE  CONVERGE  <  2  AND  NITER  <=  MAXITER  DO 

239  31$ 


$ 

$ 

$ 


$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 


$ 

$ 

$ 

$ 

$ 


Figure  C. I  Standard  MAPOL  Sequence  (Continued) 
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*****  MAPOL  SOURCE  CODE  LISTING . 

i 

STAX 

LEVI 

240 

31$ 

ASSEMBLE  THE  GLOBAL  MATRICES 

$i 

241 

31$ 

$i 

242 

31 

NITER  NITER  +  1; 

1 

243 

31 

CALL  TCEVAL  (  MOVLIM  ); 

1 

J 

244 

3! 

CALL  EMA2  (  GSIZE,  ( KGG] ,  [MGG] ,  NITER  >; 

1 

i 

245 

31$ 

$i 

246 

31$ 

BEGIN  BOUNDARY  CONDITION  LOOP  TOR  OPTIMIZATION 

$i 

247 

31$ 

$i 

248 

3! 

TOR  BC  ■  1  TO  NUMOPTBC  DO 

1 

249 

4! 

CALL  BOUND  (BC,  NMPC,  NS  PC,  NOMIT,  NRSET,  NGDR  ) : 

1 

250 

4! 

CALL  BDCASE(BC,  BLOAD,  BMASS ,  BMODES,  BSAERO,  QDP,  M INDEX, 

1 

251 

4! 

SYM,  TRMTYP,  BPLUTR,  BDYN,  BDRSP,  BDTR,  BMTR,  BOTH,  BMTR, 

1 

252 

4! 

BGUST,  BBLAST  ); 

! 

i 

253 

4! 

IP  BLOAD  <>  0  CALL  GTLOAD  (  BC,  GSIZE,  [PG]  ): 

i 

1 

254 

41 

IP  BSAERO  <>  0  THEN 

! 

255 

51 

CALL  NULLMAT  (  (AIC]  ); 

1 

256 

51 

IP  SYM  «  1  THEN 

1 

257 

61 

[AIC]  [AICMAT(MINDEX)  ]; 

t 

258 

61 

ELSE  IP  SYM  =  -I  THEN 

! 

259 

71 

[AIC]  [AAICMAT(MINDEX)  ]; 

i 

- 

260 

71 

ENDIP; 

I 

261 

61 

ENDIf; 

t 

1 

262 

51 

ENDIP; 

1 

263 

41$ 

$i 

264 

41$ 

PARTITION-REDUCTION  OP  GLOBAL  MATRICES 

$i 

265 

41$ 

$i 

266 

41 

IP  NUMOPTBC  >  I  CALL  NULLMAT  (  [KNN],  [PN],  |MNN] , 

! 

267 

51 

[GTKN 1 ,  [GSTKN],  [UGTKN]  ); 

i 

268 

41 

IP  NMPC  <>  0  THEN 

1 

269 

51$ 

$i 

1 

270 

51$ 

PERTORM  MPC  REDUCTION 

$  i 

271 

51$ 

$i 

272 

51 

CALL  GREDUCE  (  [KGG],  [PG],  [  PGMN  ( BC )  ] ,  [TMN(BC)  ] ,  [KNN],  [PN]  ); 

i 

273 

51 

IF  BMASS  <>  0  CALL  GREDUCE  (  [MSG],  ,  [PGMN(BC)  1 ,  [TMN(BC)  ]  ,  [MNN] 

>;  i 

274 

51 

IF  BSAERO  <>  0  THEN 

! 

275 

61 

CALL  GREDUCE  (,  [GTKG]  ,  [PGMN(BC)],  [TMN(BC)1,  ,  [GTKN]); 

i 

276 

61 

CALL  GREDUCE  (,  [GSTKG],  [PGMN(BC)],  [IMN(BC)],  ,  [GSTKN]); 

! 

277 

61 

ENDIP; 

i 

U 

278 

51 

IP  BPLUTR  <>  0  OR  BGUST  <>  0  OR  BBLAST  <>  0 

! 

■ 

m 

279 

61 

CALL  GREDUCE  (,  [UGTKGJ ,  [PGMN(BC)  ]  ,  [TMN(BC)1,  ,  [UGTKN]  ) ; 

i 

280 

51 

ELSE 

! 

281 

51$ 

$i 

j 

282 

51$ 

NO  MPC  REDUCTION 

$i 

283 

51$ 

$i 

284 

51 

[KNN]  [KGG]; 

i 

285 

51 

IP  BLOAD  <>  0  [PN]  [PG]; 

! 

J 

286 

51 

IP  BMASS  <>  0  [MNN]  [MGG]; 

1 

1 

287 

51 

IP  BSAERO  <>  0  THEN 

! 

288 

61 

[GTKN]  :»  [GTKG] ; 

» 

J 

289 

61 

[GSTKN]  :»  [GSTKG]; 

» 

290 

61 

ENDIP; 

1 

291 

5! 

IP  BPLUTR  <>  0  OR  BGUST  <>  0  OR  BBLAST  o  0  [UGTKN]  :»  [ UGTKG ] ; 

! 

292 

51 

ENDIP; 

1 

293 

41 

IP  NUMOPTBC  >  1  CALL  NULLMAT  (  [Krr],  |PP],  [MPP],  [GTKP  ] ,  [GSTKF], 

1 

294 

51 

[ UGTKP ]  ); 

1 

295 

41 

IP  NS PC  <>  0  THEN 

1 

296 

51$ 

$i 

297 

51$ 

PERTORM  SPC  REDUCTION 

$  i 

298 

51$ 

$i 

*• 

299 

51 

CALL  NREDUCE  (  [KNN],  [PN],  [PNSF(BC)],  [YS(BC)],  [KTP],  [KPS] , 

! 

300 

51 

[KSS],  [ PP ] ) ; 

i 

.4 

1 

Figure  C. 1  Standard  MAPOL  Sequence  (Continued) 
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MAPOL  SOURCE  CODE  LISTING 


STAT 

LEVL 

301 

51 

IF  BMASS  <>  0  CALL  NKEDUCE  (  [MNN],  ,  (PNSF(BC)),  ,  [MFF )  ); 

302 

51 

IF  BS AERO  <>  0  THEN 

303 

61 

CALL  NREDUCE  (  ,  [GTKN],  (PNSF(BC)),  ,  ,  ,  ,  (GTKF)  ) ,' 

304 

61 

CALL  NREDUCE  (  ,  [GSTKNJ ,  (PNSF(BC)] . (GSTKF)  ) ; 

305 

61 

ENDIF; 

306 

51 

IF  BFLUTR  <>  0  OR  BGUST  <>  0  OR  BBLAST  <>  0 

307 

61 

CALL  NREDUCE  (,|UOTKN),  | PNSF (BC) ) , , , , ,  (UGTKF ] ) ; 

308 

51 

ELSE 

309 

51$ 

$ 

310 

51$ 

NO  SPC  REDUCTION 

$ 

311 

51$ 

$ 

312 

51 

[KFF )  :«  (KNN); 

313 

51 

IF  BLOAD  <>  0  [PFj  (PNJ ; 

314 

51 

IF  BMASS  <>  0  [MFF)  (MNN) ; 

315 

51 

IF  BSAERO  <>  0  THEN 

316 

61 

(GTKF)  :«  [GTKN]; 

317 

61 

[GSTKF)  :«  [GSTKNJ ; 

318 

61 

ENDIF; 

319 

51 

IF  BFLUTR  <>  0  OR  BGUST  <>  0  OR  BBLAST  <>  0  (UGTKF)  :«  (UGTKN) ; 

320 

51 

ENDIF; 

321 

41$ 

$ 

322 

41$ 

ir 

STEADY  AERO  FOR  THIS  B.C.  ,  ADJUST  THE  KFF  MATRIX 

$ 

323 

41$ 

$ 

324 

41 

i  r 

BSAERO  <>  0  THEN 

325 

51 

IF  NITER  -  1  OR  NUMOPTBC  >  1  THEN 

326 

61 

CALL  TRNSPOSE  (  [GSTKF],  (GSKF)  ); 

327 

61 

(AICS)  :=  (GTKF)  *  (  TRANS((AIC))  *  (OSKFl  ); 

328 

6! 

(PAF)  :»  (QDP)  [  (GTKF)  *  ( AIRTRC ( MINDEX ) )  ); 

329 

6! 

ENDIF; 

330 

51 

[KAFF]  :»  [KFF1  -  (QDP)  [AICS]; 

331 

51 

ENDir; 

332 

41$ 

$ 

333 

41 

i  r 

NUMOPTBC  >  1  CALL  NULLMAT  (  [KAA] ,  (PA),  [MAA]  , 

334 

51 

[KAAA],  [PAA),  (UGTKA)  ); 

335 

41 

IF 

NGDR  <>  0  THEN 

336 

51$ 

$ 

337 

51$ 

PERFORM  THE  GENERAL  DYNAMIC  REDUCTION 

$ 

338 

51$ 

$ 

339 

51 

IF  NOKIT  O  O  OR  NRSET  <>  0  THEN 

340 

61$ 

$ 

341 

61$ 

OBTAIN  THE  OMITTED  DOF  PARTITION  OF  KFF  AND  MFF 

$ 

342 

61$ 

$ 

343 

61 

CALL  PARTN  (  (KFF),  [KOO],  ,  [KOA),  ,  [PFOA(BC))  ); 

344 

61 

CALL  PARTN  (  [MFF],  [MOO],  ,  ,  ,  [PFOA(BC)]  ); 

345 

6! 

ELSE 

346 

6! 

[KOO]  [KFF]; 

347 

61 

[MOO]  :«  [MFF]; 

348 

61 

ENDir; 

349 

51 

CALL  GDR1  (  [KOO],  [MOO],  [KSOO],  [GGO],  LKSET,  LJSET,  NEIV, 

350 

51 

FMAX ,  BC  ) ; 

351 

51$ 

$ 

352 

51$ 

LKSET  MEANING 

$ 

353 

51$ 

<>  0  K-SET  EXISTS 

$ 

354 

51$ 

»  0  K-SET  DOES  NOT  EXIST 

$ 

355 

51$ 

$ 

356 

5! 

IF  LKSET  <>  0  THEN 

357 

6! 

CALL  SDCOMP  (  [KSOO],  [LSOO]  ); 

358 

6! 

CALL  GDR2  1  [LSOO],  [MOO],  [PHIOKJ,  LKSET,  LJSET, 

359 

6! 

NEIV,  FMAX,  BC  ); 

360 

6! 

ENDIF; 

Figure  C.  1  Standard  MAP01.  Sequence  (Continued) 
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MAPOL  SOURCE  CODE  LISTING  ***** 


ST  XT  LEVL 


361 

5! 

362 

5! 

363 

5! 

364 

5! 

365 

5! 

366 

5! 

367 

5! 

36S 

5! 

369 

5! 

370 

6! 

371 

6! 

372 

6! 

373 

5! 

374 

5! 

375 

61$ 

376 

61$ 

377 

61$ 

376 

61 

379 

71 

360 

81$ 

361 

81$ 

362 

•  1$ 

363 

81 

364 

81 

365 

81 

366 

71 

367 

71 

366 

71 

369 

71$ 

390 

71$ 

391 

71$ 

392 

71 

393 

81 

394 

81 

395 

81 

396 

81 

397 

81 

396 

81 

399 

71 

400 

71 

401 

71 

402 

71$ 

403 

71$ 

404 

71$ 

405 

71 

406 

81 

407 

81 

406 

81 

409 

61 

410 

81 

411 

81 

412 

71 

413 

61 

414 

71 

415 

71 

416 

71 

417 

71 

416 

71 

419 

61 

CALL  GDR3  (  (KOO),  [KQA],  (NOG] ,  (PHIOK),  (TMN(BC) ) ,  (GGO) , 
(PGIGt(BC)  ] ,  (PNSr(BC)  ] ,  (PFOA(BC)],  (GSUBO(BC)), 
LKSET,  LJSET,  NOKIT,  NRSET,  GNORM,  BC  ); 

CALL  G0R4  (  BC,  GSIZE,  OS  I  ZEN,  LKSET,  LJSET,  NUMOPTBC, 

NBNDCOND,  (GDRGO(BC) ) ,  ,  ,  ,  ,  ,  (PARL(BC) )  >; 

[MAA]  TRANS  (  (GSUBO(BC) )  )  *  (  (MFF)  *  (GSUBO(BC)]  J; 

(KAA]  :«  TRANS  (  (GSUBO(BC)]  )  *  (  (KFF)  •  (GSUBO(BC))  ); 

IT  BLOAD  <>  0  (PA]  :«*  TRANS  (  (GSUBO(BC)l  )  *  (PF); 

IF  BFLUTR  <>  0  OR  BGUST  <>  0  OR  BBLAST  <>  0  THEN 
(TOPI  ]  TRANS  (  [UGTKF]  )  *  (OSUBO(BC)  ]  ; 

CALL  TRNSPOSE  (  [TOPI],  (UGTKA)  ); 

ENDIF; 

ELSE 

IF  NOKIT  <>  0  THEN 

PERFORM  THE  STATIC  REDUCTION 

IF  BSAERO  <>  0  THEN 

IF  NITER  -  1  AND  BLOAD  -  0  THEN 

FORM  (KAA]  ON  FIRST  PASS  SO  ( D]  CAN  BE  FORMED 

CALL  FREDUCE  ([KFF],  ,  (PFOA(BC)],  ,  (KOOINV(BC)  ] ,  ,  , 
(GSUBO(BC)],  (KAA)  ); 

ENDIF; 

CALL  FREDUCE  (  [KAFF],  ( PAF  ] ,  (PFOA(BC)),  BSAERO, 

(KOOL(BC) ) ,  (KOOU(BC)),  (KAO(BC)), 
(GASUBO(BC)  ] ,  (KAAA1,  (PAA),  (POARO(BC))  ); 

PERFORM  GUY  AN  REDUCTION  OF  THE  MASS  MATRIX 

IF  BMASS  <>  0  THEN 

CALL  PARTS  (  (MFF) ,  (MOO],  ,  (FDA),  [MAABAR],  (PFOA(BC)] 
(MAA]  :•  (MAABAR]  +  TRANS((MOA])  •  (GASUBO(BC)]  + 

TRANS ( (GASUBO(BC)  ]  )  •  (MOA]  + 

TRANS  ( [  GASUBO  ( BC ) ) )  *  ((MOO]  *  (OASUBO(BC)  ]  ]  ; 

IF  NRSET  <>  0  (IFM(BC)  ]  [MOO]  *  ( GASUBO  (BC)]  ♦  (MOA); 
ENDIF; 

ELSE 

CALL  FREDUCE  (  (KFF],  (PF],  (PFOA(BC)],  ,  (KOOINV(BC)  ] ,  ,  , 
(GSUBO(BC) ] ,  [KAA],  |PA],  |PO]  ); 

PERFORM  GUY  AN  REDUCTION  OF  THE  MASS  MATRIX 

IF  BMASS  <>  0  THEN 


$ 

$ 

$ 


$ 

$ 

$ 


$ 

$ 

$ 

>; 


$ 

$ 

$ 


CALL  PARTS  (  (MFF],  [MOO],  ,  (MOA),  (MAABAR],  (PFOA(BC)]  ); 
(MAA]  [MAABAR]  +  TRANS ( [MOA] )  *  (GSUBO(BC)]  + 

TRANS! (GSUBO(BC)])  *  (MOA]  + 

TRANS!  (GSUBO(BC)  ] )  *  I  [MOO]  *  (GSUBO(BC)  ]  ]; 

IF  NRSET  <>  0  (IFM(BC)J  :»  (MOO)  *  (GSUBO(BC)]  +  [MOA]; 
ENDir; 

ENDIF; 

IF  BFLUTR  <>  0  OR  BGUST  <>  0  OR  BBLAST  <>  0  THEN 


CALL  RCWPART  (  (UGTKF],  [UGTKO],  (UGTKAB) ,  (PFOA(BC)]  >; 
(TOPI)  :»  TRANS!  (UGTKO)  )  •  (OSUDO(BC) ] ; 

CALL  TRNSPOSE  (  (TOPI],  [TOP2 )  ); 

(UGTKA]  (UGTKAB)  +  (TOP2J; 

ENDIF; 


ELSE 


Figure  C.l  Standard  MAPOL  Sequence  (Continued) 
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STAT  LEVL 

420  6  ! $ 

421  61$ 

422  61$ 

421  61 

424  6! 

425  6! 

426  7! 

427  7! 

428  71 

429  61 

410  6! 

411  6! 

412  SI 

411  41$ 

414  4! 

415  51$ 

416  51$ 

417  51$ 

418  5! 

419  61 

440  61 

441  6 1 

442  6 1 

441  61 

444  7! 

445  71 

446  71 

447  61 

448  51$ 

449  51$ 

450  S!$ 

451  5: 

452  5! 

451  51 

454  51 

455  5! 

456  51 

457  5! 

458  61$ 

459  61$ 

460  61$ 

461  61 

462  61 

461  6! 

464  6! 

465  6 1 

466  6 1 

467  6! 

468  6 1 

469  6 1 

470  61 

471  6 1 

472  6 1 

471  6 ! 

474  61 

475  6! 

476  61 

477  6! 

478  6 1 

479  6! 

480  6! 

481  6! 

482  6! 


MAPOL  SOURCE  CODE  LISTING 


NO  P-SET  REDUCTION 

(KAA)  (K rr]; 

ir  BLOAD  <>  0  (PA)  (pr); 
ir  BSAERO  <>  0  THEN 
(KAAA|  :«  (KAFP); 

(PAA)  (PAP); 

ENDIP; 

IP  BPLUTR  <>  0  OR  BGUST  <>  0  OR  BBLAST  <>  0  |UGTKA)  :«  ( UGTKP I 
IP  BMASS  <>  0  [MAA]  (MPP); 

ENDIP; 

ENDIP; 

ir  NRSET  <>  0  THEN 

PERFORM  THE  SUPPORT  SET  REDUCTION 
.  NITER  -  1  THEN 

CALL  FARTN  (  (KAA) ,  ,  [KU| ,  ,  [KLL],  (PARL(BC)  ]  ) ; 

CALL  SDCOMP  (  (KLL),  (KLLINV(BC) )  ); 

CALL  PBS  (  (KLLINV(BC)  ] ,  (KLR),  (D(BC)),  NEOl  ); 

ELSE 

IF  BLOAD  (>  0  THEN 

CALL  PARTN  (  (KAA),  ,  (KLR),  ,  (KLL),  (PARL(BC) )  ); 

CALL  SDCOMP  (  (KLL),  (KLLINV(BC) )  ); 

ENDIP; 

ENDIP; 

CALCULATE  THE  REDUCED  MASS  MATRIX 

CALL  PARTN  ((MAA),  [MRRBAAI,  [MLR] ,  ,  (MLL) ,  (PARL(BC)  ] ) ; 

(irR(BC))  (MLL)  *  (D(BC))  ♦  (MLR); 

(MRR(BC))  s-  (MRRBAR)  +  TRANS  |  (MLR)  )  *  (D(BC))  ♦ 

TRANS  (  (D(BC)I  )  *  (IFR(BC)]; 

(R22 |  TRANS  (  (D(BC>)  )  *  (MLR)  ♦  (MRRBAR); 

CALL  TRNSPOSE  (  (IPR(BC)l,  (R21)  ); 

IP  BSAERO  <>  0  THEN 

PROCESS  STEADY  AEROELASTIC  DISCIPLINE 

CALL  PARTN  (  ( KAAA] ,  (KARR),  [KALR],  I  KARL) ,  [KALL], 

(PARL(BC) )  ) ; 

(R12)  :*=  TRANS  ( [  D(  BC)  ) )  *  (KALR)  +  (KARR); 

(Rll)  :*  TRANS ( (D(BC) ) )  •  (KALL)  +  (KARL); 

CALL  MERGE  (  [Kill,  (R22),  (KALR),  [R21],  (KALL),  (PARL(BC)  ]  ) 
CALL  RCWPART  (  (PAA),  (PARBAR),  (PAL),  (PARL(BC)  ]  ); 

CALL  YSMERGE  (  (PI),  ,  (PAL),  (PARL(BC) )  ); 

CALL  YSMERGE  (  (K12(BC)|,  ,  (IPR(BC)),  (PARL(BC) )  ); 

CALL  COLMERGE  (  (K21(BC) )  ,  (R12),  (Rll),  (PARL(BC) ]  ); 

CALL  DECOMP  (  (Kill ,  (KLll(BC)],  (KUll(BC))  ); 

CALL  GPBS  ( (KL11 ( BC ) ) ,  (KUll(BC)),  ( K1 2 ( BC ) ) ,  (K1112(BC)),  NEG- 
CALL  GFBS  ((KLU(BC)],  (KUll(BC)),  (PI),  (PAR(BC)]); 

(LHS(BC)|  :»  (MRP(BC)l  +  [ K21 (BC) )  *  (K1112(BC)); 

(P2)  :*  (PARBAR)  4  TRANS ( (D(BC) ) )  *  (PAL); 

(RHS(BC)]  (P2)  -  [K21 ( BC) )  *  (PAR(BC)); 

CALL  SAEROI  BC,  (LHS(BC)),  (RHS(BC)),  |AR) ,  (DELTA), 

[P2 J ,  (MRR(BC)l); 

(AL)  :=  (D(BC) ]  •  (AR); 

CALL  ROWMERGE  (  [AA],  (AR),  (AL),  (PARL(BC)  )  ); 

|UA]  :=•  ( K1 1 1 2 ( BC ) )  *  (AR)  +  (PAR(BC))  *  (DELTA); 

IP  NOMIT  <>  0  (PO)  (POARO(BC))  *  (DELTA)  ; 

ENDIP; 


Figure  ((.  I  Standard  MAPOI,  Sequence  (Continued) 
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*****  MMOL  SOURCE  CODE  LISTING 

STAX  LEVL 


483 

51$ 

$1 

484 

51 

ir  BLOAD  <>  0  THEN 

485 

61$ 

$1 

486 

61$ 

PROCESS  STATICS  WITH  INERTIA  RELIEF 

$1 

487 

61$ 

$1 

488 

61 

CALL  MERGE  (  [Kill,  [ R22 ] ,  [ KLR) ,  |R21), 

489 

61 

[KLL] ,  [PARL(BC))  ); 

490 

61 

CALL  YSMERGE  (  (PI),  ,  (PLBAR) ,  (PARL(BC)  )  ); 

491 

61 

CALL  YSMERGE  (  (K12(BC)),  ,  (IFR(BC)),  (PARL(BC) )  ); 

492 

61 

CALL  DECOMP  (  (Kll),  (KLil(BC)],  (KUll(BC)]  >  ; 

493 

61 

(PI)  (PI)  -  (K12(BC)1  *  [AR]; 

494 

61 

CALL  GFBS  (  (KLll(BC)),  (KUll(BC)),  (PI),  (UA),  NEG1  ); 

495 

61 

(LHS(BC) 1  (MRR(BC)]; 

496 

61 

(RHS(BC))  TRANS((D(BC) ])  *  (PLBAR)  +  [PR]; 

497 

61 

CALL  INERTIA  (  (LHS(BC)],  (RHS(BC)],  (AR)  ); 

498 

61 

(AL)  (D(BCI)  *  (AR); 

499 

61 

CALL  ROW4ERQE  (  [AA] ,  (AR),  [AL] ,  (PARL(BC)  )  ); 

500 

61 

(PI)  (PI)  -  [K12(BC)1  *  (AR); 

501 

61 

CALL  GFBS  (  (KL1I),  (KU11),  (PI),  (UA)  ); 

502 

61 

ENDIF; 

503 

51 

IF  BMDDES  <>  0  THEN 

504 

61 

CALL  REIG  (  BC,  (KAA) ,  (MAA) ,  (MRR(BC)  ) ,  [D(BC)|,  LAMBDA, 

505 

61 

(PHIA),  (Mil),  HSIZE  ); 

506 

61 

CALL  FCEVAL  (  BC,  LAMBDA  ); 

507 

61 

ENDIF; 

508 

51 

ELSE 

509 

51$ 

$1 

510 

51$ 

NO  SUPPORT  SET  REDUCTION 

$1 

511 

51$ 

$1 

512 

51 

IF  BLOAD  <>  0  THEN 

513 

61 

CALL  SDCOMP  (  (KAA),  (KLLINV(BC)  )  ); 

514 

61 

CALL  FBS  (  (KLLINV(BC)  1 ,  (PA),  (UA)  ); 

515 

61 

ENDIF; 

516 

51 

IF  BSAERO  <>  0  THEN 

517 

61$ 

$1 

518 

61$ 

NOT  FUNCTIONAL,  REQUIRES  (DELTA)  TO  BE  INPUT 

$1 

519 

61$ 

$1 

520 

61 

CALL  DECOMP  (  [KAAA]  ,  (KLLL(BC)  )  ,  (KLLU(BC)]  ); 

521 

6! 

CALL  GFBS  (  (KLLL(BC)J,  (KLLU(BC) ) ,  (PAA),  (UA)  ); 

522 

61 

ENDIF; 

523 

51 

IF  BM3DES  <>  0  THEN 

524 

61 

CALL  REIG  (  BC,  (KAA),  (MAA),  ,  ,  LAMBDA,  (PHIA),  (Mil),  HSIZE 

);  i 

525 

61 

CALL  FCEVAL  (  BC,  LAMBDA  ); 

526 

61 

ENDIF; 

527 

51 

ENDIF; 

528 

41$ 

$i 

529 

41$ 

PERFORM  ANY  DYNAMIC  ANALYSES  —  NOTE  THAT  THESE  ARE  INDEPENDENT 

$i 

530 

41$ 

or 

THE  SUPPORT  SET 

$i 

531 

41$ 

$i 

532 

41 

ir 

BDYN  <>  0  THEN 

533 

51 

CALL  QHHLGEN  (BC,  [QKKL] ,  (QKJL),  [UGTKAJ,  [PHIA], 

534 

51 

[PHIKH],  (QHHL(BC)),  (QHJL) ) ; 

535 

51 

CALL  DMA  (  BC,  GSIZE,  [MAA],  (KAA),  (TMN(BC)  ] ,  (GSUBO(BC)),  NGD1I 

536 

51 

LAMBDA,  [PHIA],  [MDD],  [  BDD] ,  (KDDT),  ( KDDF] , 

l 

537 

51 

(MHH(BC) ) ,  [ BHH ] ,  (KHHT),  (KHHF(BC) ]  ); 

538 

51 

CALL  DYNLOAD  (  BC,  GSIZE,  (TMN(BC)],  (GSUBO(BC)],  NGDR, 

539 

51 

[PHIA],  (QHJL),  [ PET] ,  [PDF]  ) ; 

540 

51 

IF  BFLUTR  <>  0  CALL  FLUTTRAN  <  BC,  (QKHL(BC)],  LAMBDA,  HSIZE, 

541 

61 

(MHH(BC)],  (KHHF(BC)]  ) ; 
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STAT  LEVL 

542  51 

543  61 

544  61 

545  61 

546  6 1 

547  61 

546  61 

549  61 

550  51 

551  41 

552  51 

553  51 

554  SI 

555  5! 

556  5 1 

557  51 

558  51 

559  51 

560  51 

561  51 

562  51 

563  51 

564  5! 

565  51 

566  5 1 

567  51 

568  51 

569  51 

570  5 1 

571  51 

572  5! 

573  51 

574  51 

575  5! 

576  51 

577  5! 

578  51 

579  4  !$ 

580  41$ 

581  41$ 

582  4! 

583  41 

584  51$ 

585  51$ 

586  51$ 

587  5! 

588  61 

589  6! 

590  61 

591  5! 

592  6! 

593  61 

594  61 

595  5! 

596  5! 

597  51 

598  51 


*****  MAPOL  SOURCE  CODE  LISTING  ***** 

IP  BDRSP  <>  0  THEN 

CALL  DYNRSP  (BC,  (MDO) ,  [BDD),  [KDDT] ,  (KDOF),  (HHH(BC)  ) ,  (BHH  , 
(MOTT),  (KHHP(BC) ) ,  (POT),  (PDP),  [QKHL(BC) ) , 
tUTRANA],  [UPREQA),  [UTRANI) ,  (UFREQI) ,  [UTRANE), 
1UPREQE]  ) ; 

ir  BMTR  <>  0  [UTRANA]  |PHIA)  »  [UTRANI ) ; 
ir  BMTR  <>  0  (UPREQA)  :■  (PHIA)  *  [UFREQI); 

ENDIP; 

ENDIP; 

IP  BBLAST  <>  0  THEN 

CALL  BLASTFIT  (  BC,  (QJJL),  (MATTR) ,  (HATSS),  BQDP,  (BPRC), 

(DWNWSH),  HSIZE,  (ID2),  [HP ART) ,  (UGTKA), 

(BLGTJA),  (BLSTJA)  ); 

CALL  COLPART  (  (PHIA),  ,  (PHIE),  [HP ART]  ); 

CALL  RCMKERGE  (  (PHIR),  [ID2),  (D(BC)),  [  PARL(BC) )  ); 

CALL  COLKERGE  (  (PHIB),  [PHIR),  [PHIE),  [HP ART)  ); 

(GENM)  :«  TRANS!  [PHIB]  )  •  [  (MAA)  •  (PHIB)  ); 

IGENK)  TRANS!  [PHIB)  )  *  [  [ KAA)  *  [PHIB)  ); 

( DTSLP )  TRANS  (  [BLSTJA)  )  *  [PHIB); 

1  FTP )  TRANS  (  (PHIB)  )  *  [BLGTJA); 

[GENF]  (BQDP)  [FTP]  *  IBPRC); 

(GENFA)  (BQDP)  [PTT]  *  (HATSS); 

(GENQ)  [GENFA]  '  [DTSLP); 

(GENQL)  :=  (BQDP)  [FTP)  *  (MATTR) ; 

CALL  PARTN  (  [ GENQ ) , ( QRR ]  ,  ,  [QRE ] ,  [QEE) ,  (HP ART)  ); 

CALL  PARTN  (  [GENK],  ,  ,  ,  [KEE),  (HP ART)  ); 

(KEQE)  [QEE]  +  (KEE); 

CALL  DECOMP  (  [KEQE],  [LKQ) ,  (UKQ)  ); 

CALL  ROWPART  (  [GENF) ,  [GPR) ,  [ GFE ) ,  [HP ART)  ); 

CALL  GFBS  (  [LKQ],  [UKQ],  (GFE) ,  [BTEHJ  ); 

[DELHI  -(QRE)  *  [STEM]  +  [GPR]; 

CALL  BLASTRIM  (  BC,  (DELM),  [HRR(BC)),  (URDB) ,  (DELB)  ); 

[ELAS]  [ BTEM]  *  [DELB]; 

[SLPM0D]  TRANS  (  [BLSTJA)  )  *  [PHIE]; 

CALL  BLASTDRV  (  BC,  [GENM],  [GENK),  (GENFA),  [GENQL),  (DELB), 

(URDB),  (DWNWSH),  [SLPMDD),  [ELAS),  (UBLASTI)  ).* 

ENDIF; 

$ 

BEGIN  THE  DATA  RECOVERY  OPERATIONS  $ 

$ 

IP  NUMOPTBC  >  1  CALL  NULLMAT  ([UP),  [AF],  [PHIPJ,  [UTRANTJ  ,  (UPREQP)  ; 
IP  NGDR  <>  0  THEN 

$ 

DATA  RECOVERY  WITH  GDR  $ 

$ 

IP  BLOAD  <>  0  THEN 

[UP)  :<*  (GSUBO(BC) )  *  [UAI; 

IP  NRSET  <>  0  [API  :»  (GSUBO(BC) )  *  [AAJ; 

ENDIP; 

ir  BSAERO  <>  0  THEN 

(UP)  :=  [GSUBO(BC) ]  *  [UA); 

IP  NRSET  <>  0  [AT)  [GSUBO(BC))  *  [AAJ ; 

ENDIP; 

ir  BM0DES  <>  0  (PHir)  :»  [GSUBO(BC))  *  [PHIA); 

IP  BDTR  <>  0  OR  BMTR  <>  0  [UTRANF)  :»  [GSUBO(BC) )  *  (UTRANA); 

IT  BDPR  <>  0  OR  BMTR  <>  0  [UPREQP)  :=  [GSUBO(BC) )  *  (UPREQA); 

ELSE 
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5TAT  LEVL 


599 

51 

600 

61$ 

601 

61$ 

602 

61$ 

603 

61 

604 

71 

605 

71 

606 

71 

607 

81 

608 

71 

609 

61 

610 

71 

611 

71 

612 

71 

613 

71 

614 

81 

615 

71 

616 

61 

617 

71 

618 

7! 

619 

71 

620 

61 

621 

71 

622 

71 

623 

71 

624 

61 

625 

71 

626 

71 

627 

71 

628 

61 

629 

61$ 

630 

61$ 

631 

61$ 

632 

61 

633 

71 

634 

71 

635 

71 

636 

61 

637 

71 

638 

71 

639 

71 

640 

61 

641 

61 

642 

61 

643 

61 

644 

51 

645 

41$ 

646 

41 

647 

41 

648 

51$ 

649 

51$ 

650 

51$ 

651 

51 

652 

61 

653 

61 

654 

61 

655 

51 

656 

61 

657 

61 

658 

61 

659 

51 

660 

61 

MMOL  SOURCE  CODE  LISTING 


ir  NOKIT  <>  0  THEN 


DATA  RECOVERY  WITH  STATIC  CONDENSATION 
ir  BLOAD  <>  0  THEN 

CALL  RECOVA  (  (UA(,  [PO[ ,  (GSUBO(BC)t.  NRSET,  ( AA[ , 

[IPMlBCIt,  ,  [KOOINV(BC)[,,|PFaA(BC)[,  [UT(  ) 

ir  NRSET  <>  0  CALL  RECOVA  (  [ AA[ ,  ,  (GSUBO(BC)[ . 

(PFOA(BC)[,  (AM  >; 

ENDIP; 

ir  BSAER0  <>  0  THEN 

CALL  RECOVA  (  (UA[  ,  [PO[,  ( GASUBO  ( BC )  ( ,  NRSET,  ( AA( , 

[IPM(BC)[,  BSAERO,  [KOOL(BC)[,  (KOOU(BC)[, 
[PPOA(BC)[,  |UF|  ); 

IF  NRSET  <>  0  CALL  RECOVA  (  [AA[ , ,  ( GASUBO  (BC)  l ,,,,,, , 

[PFOA(BC) [ ,  (ATI ) ; 

ENDIP; 

ir  BMODES  <>  0  THEN 

IPHIO)  l GSUBO ( BC ) )  *  tPHIAl ; 

CALL  ROHHERGE  (  [PHir[,  tPHIO[,  [  PHIA  ( ,  (PPOA(BC)t  ); 

ENDIP; 

IP  BDTR  <>  0  OR  BHTR  <>  0  THEN 

CALL  RECOVA  (  [UTRANAl.  ,  |GSUBO( BC) 

[PPOA(BC)  [ ,  (UTRAMPt  ).' 

ENDIP; 

ir  BDPR  <>  0  OR  BMPR  <>  0  THEN 

CALL  RECOVA  (  [UPREQAl,  ,  |GSUBO(  BC)  , 

( PPOA(BC) [ ,  [UTREQPl  ); 

ENDIP; 

ELSE 

DATA  RECOVERY  WITHOUT  P-SET  REDUCTION 


IP  BLOAD  <>  0  THEN 
(UP)  [UA[; 

IP  NRSET  <>  0  [API  [AA[; 

ENDIP; 

IP  BSAERO  <>  0  THEN 
[UT(  [UA(; 

IP  NRSET  <>  0  [API  [AA[; 

ENDIP; 

IP  BMODES  <>  0  [PHIP[  [ PHIA [ ; 

IP  BDTR  <>  0  OR  BlfTR  <>  0  [UTRANF[ 

IP  BDPR  <>  0  OR  BMPR  <>  0  [UPREQP[ 

ENDIP; 

ENDIP; 


[UTRAKAl; 

[UPRPQAU 


IP  NUMOPTBC  >  1  CALL  NULU1AT  (  [UN[,  [ AN[ ,  [PHIN[  ); 
IP  NS PC  <>  0  THEN 


DATA  RECOVERY  WITH  SPC-REDUCTION 


IF  BLOAD  <>  0  THEN 

CALL  YSMERGE  (  [UN),  (YS(BC)l,  [UF[,  [PNSP(BC)[  ); 

IP  NRSET  <>  0  CALL  YSMERGE  (  (AN[,  ,  [AF(,  (PNSP(BC)]  ); 
ENDIP; 

IP  BSAERO  <>  0  THEN 

CALL  YSMERGE  (  [UN[,  (YS(BC)(,  [UF[,  [PNSP(BC)(  ); 

IP  NRSET  <>  0  CALL  YSMERGE  (  [ AN [ ,  ,  [AP[,  [PNSP(BC)[  ); 
ENDIP; 

IP  BMODES  <>  0  CALL  YSMERGE  (  [PHIN[,  [YS(BC)[,  [PHIF[, 

[PNSP(BC) [  ) ; 


$ 

$ 

$ 


$ 

$ 

$ 


$ 


$ 

$ 

$ 
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MAPOL  SOURCE  CODE  LISTING 


STAT 

LEVL 

661 

5! 

IF  BDTR  <>  0  OR  BMTR  <>  0 

662 

6! 

CALL  YSMERGE  (  ]  UTRANN] ,  ]YS(BC)],  IUTRANF]  , 

663 

6! 

[PNSF(BC)],  BDTR  )1 

664 

51 

IF  BDFR  <>  0  OR  BMTR  <>  0 

'665 

6! 

CALL  YSMERGE  (  ]UFREQN],  [YS(BC)],  ] UFREQF ) , 

666 

61 

IPNSF(BC)!,  BDFR  ); 

667 

51 

ELSE 

668 

51$ 

669 

51$ 

DATA  RECOVERY  WITHOUT  SPC-REDUCTION 

670 

51$ 

671 

51 

IF  BLOAD  <>  0  THEN 

672 

61 

[UN]  [UFJ; 

673 

61 

IF  NRSET  <>  0  JAN]  :«  1AF) ; 

674 

61 

ENDIF; 

675 

51 

IF  BSAERO  <>  0  THEN 

676 

61 

! UN ]  luri; 

677 

61 

IF  NRSET  <>  0  [AN]  t-  [AT]; 

678 

61 

ENDIF; 

679 

51 

IF  BMODES  <>  0  [PHIN]  :»  ]PHIF); 

680 

51 

IF  BDTR  <>  0  OR  BMTR  <>  0  [UTRANN]  (UTRANA) ; 

681 

51 

IF  BDFR  <>  0  OR  BMTR  <>  0  [UFREQN]  :«  [UTREQA] ; 

682 

51 

ENDIF; 

683 

41$ 

684 

41 

IF 

NUMOPTBC  >  1  CALL  NULLMAT  (  |UG(BC)],  [AG(BC)],  )PHIO(BC))  ); 

685 

41 

ir 

NMPC  <>  0  THEN 

686 

51$ 

687 

51$ 

DATA  RECOVERY  WITH  MPC-REDUCTION 

688 

51$ 

689 

51 

IF  BLOAD  <>  0  THEN 

690 

61 

]UM]  :=  ]TMN(BC)]  *  [UN]; 

691 

61 

CALL  ROWMERGE  (  [UG(BC)],  [UM],  [UN],  ]PGMN(BC)]  ); 

692 

61 

IF  NRSET  <>  0  THEN 

693 

71 

[UM]  :«  ]TMN(BC]]  *  ]AN) ; 

694 

71 

CALL  RCWMERGE  (  JAG(BC)],  [UM],  ]AN],  [PGMN(BC)  ]  ); 

695 

71 

ENDIF; 

696 

61 

ENDIF; 

697 

51 

IF  BSAERO  <>  0  THEN 

698 

61 

]UK]  :*  ]TMN(BC)|  *  ]UN]; 

699 

61 

CALL  ROWMERGE  (  [UG(BC)|,  ]UM),  [UN],  [PGMN(BC) ]  ); 

700 

61 

IF  NRSET  <)  0  THEN 

701 

7! 

|UM]  :»  [ TMN ( BC ) ]  *  [AN]; 

702 

71 

CALL  ROWMERGE  (  ]AG(BC)|,  [UM],  [AN],  IPGMt(BC)]  )  ,* 

703 

71 

ENDIF; 

704 

61 

ENDIF; 

705 

51 

IF  BMODES  <»  0  THEN 

706 

6! 

]UM]  :■  ]TMN(BC) ]  *  [PHIN]; 

707 

6! 

CALL  ROWMERGE  (  ]PHIG(BC)],  [UM],  )PHIN),  ]PGMN(BC)]  ) ; 

708 

61 

ENDIF; 

709 

5! 

IF  BDTR  <>  0  OR  BMTR  <>  0  THEN 

710 

6! 

] UM]  :=  ]TMN(BC)J  *  [UTRANN]; 

711 

61 

CALL  ROWMERGE  (  [UTRANG],  [UM],  [UTRANN],  ]PGMN(BC)  ]  )  ; 

712 

61 

ENDIF; 

713 

51 

IF  BDFR  <>  0  OR  BMTR  <>  0  THEN 

714 

61 

]UM J  [TMN(BC] ]  *  [UFREQN]; 

715 

61 

CALL  RCMMERGE  (  [UFREQG] ,  [UM],  [  UFREQN  ] ,  [PGMN(BC)  ]  )  ; 

716 

61 

ENDIF; 

717 

51 

ELSE 

718 

51$ 
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</v  </v  </v  </v  </></></> 


STAX 

719 

LEVL 

51$ 

*****  MAPOL  SOURCE  CODE  LISTING  ***** 

DATA  RECOVERY  WITHOUT  MPC-REDUCTION 

$1 

720 

5!$ 

$1 

721 

51 

IP  BLOAD  <>  0  THEN 

722 

6! 

(UG1BC) ]  (UN); 

723 

61 

IP  NRSET  <>  0  (AG(BC) ]  :»  [AN]; 

724 

61 

ENDIP; 

725 

51 

IP  BSAERO  <>  0  THEN 

726 

61 

(IXJ(BC)l  :«  [UN]; 

727 

61 

IP  NRSET  <>  0  [AG(BC) ]  :«  [AN]; 

728 

61 

ENDir; 

729 

51 

IP  BMODES  <>  0  (PHIG(BC) ]  :«  (PHINJ; 

1 

730 

51 

IP  BDTR  <>  0  OR  BMTR  <>  0  [UTRANG]  [UTRANN]; 

731 

51 

IP  BDTR  <>  0  OR  BMFR  <>  0  [UPREQG]  :«  [UTREQN] ; 

732 

51 

ENDIP; 

733 

41$ 

$1 

734 

41$ 

RECOVER  PHYSICAL  BLAST  DISCIPLINE  DISPLACEMENTS 

$! 

735 

41$ 

$1 

736 

41 

ir  BBLAST  <>  0  [UBLASTG]  (PHIO(BC)]  *  (UBLASTI); 

737 

41$ 

$1 

738 

41$ 

PERFORM  CONSTRAINT  EVALUATION  fOR  STATIC  DISCIPLINES 

$! 

739 

41$ 

$1 

740 

41 

CALL  DC  /AL  (  BC,  (UG(BC)]  ); 

.741 

41 

IP  BLOAD  <>  0  OR  BSAERO  <>  0  CALL  SCEVAL  (  BC,  [QLBSIG],  [UG(BC>], 

742 

51 

TRMTYP  ); 

743 

41$ 

$1 

744 

41$ 

HANDLE  OUTPUT  REQUESTS 

$1 

745 

41$ 

$! 

746 

41 

CALL  OFPLOAD  (  NUMOPTBC,  BC,  NITER,  GSIZE,  |PG],  TRMTYP,  QDP, 

747 

41 

[GTKG],  ( AIRPRCfMINDEX )  ] ,  [DELTA]  ); 

748 

41 

CALL  OFPDISP  (  NUMOPTBC,  BC,  NITER,  GSIZE,  [UG(BC)),  (AG(BC) ) , 

749 

41 

TRMTYP,  [UG(BC)],  [  AG  ( BC ) ) ,  [UBLASTG],  ,  [UTRANG], 

750 

41 

[UTRANE],  [UPREQG],  [  UFREQE  ] ,  LAMBDA,  [PHIO(BC)]  ); 

751 

41 

CALL  EDR  (  NUMOPTBC,  BC,  NITER,  NDV,  GSIZE,  EOSUWRY,  EODISC, 

752 

41 

[UG(BC)  ] ,  [UG(  BC)  ] ,  ,  [UTRANG],  [UFREQG] ,  [PHIO(BC)]  ) ; 

753 

41 

CALL  OPPEDR  (  BC,  HSIZE,  NITER,  TRMTYP  ); 

754 

41 

ENDDO; 

755 

31$ 

$1 

756 

31$ 

SELECT  ACTIVE  CONSTRAINTS 

$1 

757 

31$ 

$1 

758 

31 

NRPAC  ;«  3.0; 

759 

31 

EPS  :=  -  0.10; 

760 

3! 

CALL  ACTCON  (  NITER,  MAXITER,  NRPAC,  NDV,  EPS,  CONVERGE, 

761 

31 

CTL,  CTLMIN,  [AMAT]  ); 

762 

31$ 

$1 

763 

31 

IP  CONVERGE  <  2  AND  NITER  <=  MAXITER  THEN 

764 

41$ 

$1 

765 

41$ 

CHECK  FOR  PSD  ITERATIONS 

$! 

766 

41$ 

$1 

767 

41 

CALL  PSD  (  NDV,  NITER,  MAXPSD,  OPSTRAT,  ALPHA,  FSDFLG, 

768 

41 

CNVRGLIM,  CONVERGE,  CTL,  CTLMIN  ); 

769 

41$ 

$1 

770 

41 

ir  PSDPLG  »  0  THEN 

771 

51$ 

$1 

772 

51$ 

USE  MATHEMATICAL  PROGRAMMING  METHODS 

$1 

773 

51$ 

OBTAIN  THE  SENSITIVITIES  OF  THE  CONSTRAINTS  WRT  THE 

$1 

774 

51$ 

DESIGN  VARIABLES 

$! 

775 

51$ 

$! 

776 

51 

CALL  MAKDPV  (NDV,  [AMAT],  MOVLIM  ); 

777 

51$ 

$1 

Figure  C.l  Standard  MAPOL  Sequence  (Continued) 
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MAPOL  SOURCE  CODE  LISTING 


STAT  LEVL 


ns 

5!$' 

779 

5!$ 

7*0 

5!$ 

781 

5!$ 

782 

51 

783 

6! 

784 

6! 

785 

61 

786 

6! 

787 

7!$ 

788 

71$ 

789 

71$ 

790 

71 

791 

71$ 

792 

71$ 

793 

71$ 

794 

71 

793 

81 

796 

8! 

797 

71 

798 

81$ 

799 

81$ 

800 

81$ 

801 

8! 

802 

81 

803 

91$ 

804 

91$ 

805 

91$ 

806 

9! 

807 

91 

808 

91$ 

809 

91$ 

810 

91$ 

811 

91 

812 

91 

813 

81$ 

814 

81$ 

815 

81$ 

816 

81$ 

817 

81 

818 

81$ 

819 

81$ 

820 

81$ 

821 

81$ 

822 

81 

823 

81$ 

824 

81 

825 

81 

826 

81 

827 

91 

828 

91 

829 

91 

830 

91 

831 

91 

832 

91 

833 

91 

834 

81$ 

835 

81$ 

836 

81$ 

..............I.....*..............*...........................***; 

SENSITIVITY  EVALUATION  TOR  BOUNDARY  CONDITION  DEPENDENT  CONSTRAIN. 'S$ 
. * . . 

$ 

TOR  BC  »  1  TO  NUMOPTBC  DO 

CALL  ABOUND  (  BC,  ABC,  PCA,  NAU,  NACSD,  [PGA),  ADC,  APC,  AAC, 
TRMTYP,  MINDEX,  NAE,  NAUE,  PAE, 

NMPC,  NS  PC,  NOHIT,  NRSET,  NGDR,  C'G(BC)  1  ); 

IF  ABC  >  0  THEN 

$ 

EVALUATE  FREQUENCY  CONSTRAINT  SENSITIVITIES  $ 

$ 

IF  ADC  <>  0  CALL  FREQSENS  [  BC,  ADC,  NEW,  (PHIG(BC)),  |AMAT;  ) ; 

EVALUATE  FLUTTER  CONSTRAINT  SENSITIVITIES 

ir  AFC  <>  0  CALL  FLUTSENS  (  BC,  GSIZE,  NDV,  (QHHL(BC) ) , 

(MHH(BC)J,  (KHHF(BC)J, 

(PHIG(BC)l,  [ AMAT ) ) ; 

IF  NAU  >  0  THEN 

SENSITIVITIES  OF  CONSTRAINTS  WRT  DISPLACEMENTS 

CALL  NULIMAT  (  1DFDUJ,  [DPGV)  )  ; 

IF  NACSD  >  NAU  *  NDV  OR  AAC  <>  0  THEN 

USE  GRADIENT  METHOD 

CALL  MAKDFU  {  BC,  GSIZE,  [DFDU]  ); 

ELSE 


USE  VIRTUAL  LOAD  METHOD 

CALL  MAKDFU  (  BC,  GSIZE,  [DPGV)  ); 
ENDIF ; 


SOME  RELATIVELY  SIMPLE  CALCULATIONS  THAT  PRECEDE  THE 
LOOP  ON  THE  DESIGN  VARIABLES 


CALL  COLPART  (  (UG(BC)l,  ,  [UOA],  [PGA)  ) ; 

OBTAIN  THE  SENSITIVITIES  OF  THE  DESIGN 
DEPENDENT  LOADS 

CALL  DDLOAD(NDV,  GSIZE,  BC,  DDFLG,  [PGA1,  1DPVJ)); 

CALL  MAKDVU  (  NDV,  )UGA)  ,  ( DKUG  ]  ,  GMKCT,  DKVI  ); 
CALL  NUUMAT  (  )DUG)  ); 

IF  NRSET  <>  0  THEN 

CALL  COLPART  (  (AG(BC)),  ,  (AGA) ,  (PGA)  )  ; 

CALL  MAKDVU  (  NDV,  ]AGA],  ] DMAG] ,  GMMCT,  DMVI  ); 
(DUG)  (DKUG)  +  ]DMAG ] ; 

CALL  MAKDVU  (  NDV,  ]UGA),  JDMUG) ,  GMMT,  DMVI  ); 
ELSE 

[DUG]  ] DKUG )  ,* 

ENDIF; 

ACCOUNT  FOR  VIRTUAL  LOAD  METHOD 


$ 

$ 

$ 

$ 

$ 


$ 

$ 

$ 
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..... 

*****  MAJPOL  SOURCE  CODE  LISTING  ***** 

STAT 

LEVL 

837 

81 

IF  NACSD  >  NAU  *  NDV  OR  AAC  <>  0  THEN 

! 

838 

91$ 

$1 

839 

91$ 

USE  GRADIENT  METHOD 

$i 

840 

91$ 

$i 

841 

91 

ir  DDF  LG  >  0  THEN 

1 

842 

101 

{ DPGV )  :=  (DPVJ1  +  (DUG); 

! 

843 

101 

ELSE 

! 

844 

101 

(DPGV)  (DUG); 

! 

845 

101 

ENDIF; 

! 

846 

91 

ELSE 

i 

847 

91$ 

$i 

848 

91$ 

USE  VIRTUAL  LOAD  METHOD 

$i 

849 

91$ 

$i 

850 

91 

IF  DDFLG  >  0  THEN 

i 

851 

101 

[DFDU]  :«  ( DPVJ )  +  (DUG); 

! 

852 

101 

ELSE 

i 

853 

101 

(DFDU)  :<=  (DUG); 

! 

854 

101 

ENDIF? 

I 

855 

91 

ENDIF; 

! 

856 

81$ 

$i 

857 

81$ 

REDUCE  THE  RIGHT  HAND  SIDES  TO  THE  L  SET 

$i 

858 

81$ 

$i 

859 

81 

CALL  itULLMAT  (  (DPNV),  (DMUN)  ); 

1 

860 

81 

IF  NMPC  <>  0  THEN 

! 

861 

91 

CALL  GREDUCE  (,(DPGV),  (PGMN(BC) ) ,  (TMN(BC) ) , ,  (DPNV)); 

I 

862 

9! 

IF  NRSET  <>  0 

! 

863 

101 

CALL  GREDUCE (  ,  (DMUG)  ,  (PGMN(BC)  ) ,  (TMN(BC)  ) ,  ,  (DMUN) )  ;  1 

864 

91 

ELSE 

! 

865 

91 

(DPNV)  :«  (DPGV); 

! 

866 

91 

IF  NRSET  <>  0  (DMUN)  :=  (DMUG); 

1 

867 

91 

LUD7F; 

1 

868 

81$ 

$i 

869 

81 

CALL  NULLMAT  (  (DPFV),  ( DKUF )  ); 

1 

870 

6! 

IF  NS  PC  >  0  THEN 

1 

871 

91 

'• X  NREDUCE  (,  (DPNV),  (PNSF(BC)),  ,  ,  ,  ,  (DPFV)); 

! 

872 

91 

IF  NRSET  <>  0 

i 

873 

101 

CALL  NREDUCE  (,  (DMUN),  (PNSF(BC)),  ,  ,  ,  ,  (DMUF)  ) 

874 

91 

ELSE 

i 

875 

9! 

(DPFV)  :»  (DPGV); 

i 

876 

91 

IF  NRSET  <>  0  (DMUF)  :■=  (DMUN); 

i 

877 

91 

ENDIF; 

! 

878 

81$ 

$i 

879 

81 

CALL  NULLMAT  (  [DPAVJ,  (DMUA)  ); 

I 

880 

81 

IF  NGDR  <>  0  THEN 

I 

881 

91 

( DPAV )  TRANS!  (GSUBO(BC)  )  )  *  (DPFV); 

! 

882 

9! 

IF  NRSET  <>  0  (DMUA)  :»  TRANS!  (GSUBO(BC))  )  •  (DMUF); 

! 

883 

91 

ELSE 

I 

884 

9! 

IF  NOMIT  <>  0  THEN 

1 

885 

101 

IF  AAC  <>  0  THEN 

! 

886 

111 

CALL  FREDUCE  (  ,  (DPFV),  (PFOA(BC)),  AAC, 

! 

887 

111 

(KOOL(BC)J,  (KOOU(BC)), 

! 

888 

111 

(KAO(BC)),  (GASUBO(BC)i,  , 

I 

889 

111 

(DPAV),  (DPOV)  ); 

! 

890 

111 

IF  NRSET  O  0 

! 

891 

121 

CALL  TREDUCE  (  ,  (DMUF),  (PFOA(BC)),  AAC, 

! 

892 

121 

(KOOL1BC) J ,  (KOOU(BC)), 

! 

893 

121 

(KAO(BC) ) ,  (GASUBO(BC) ) ,  , 

1 

894 

121 

(DMUA),  |DMUO)  ); 

! 

895 

111 

ELSE 

1 

896 

11! 

CALL  FREDUCE  (,  (DPrV),  (PFOA(BC)),  , 

1 

897 

Ill 

(KOOINV(BC) ) ,  ,  ,  (GSUBO(BC)),  , 

1 

898 

111 

(DPAV),  (DPOV)  ); 

t 

, 
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*****  MAPOL  SOURCE  CODE  LISTING 

STAT  LEVL 


S99 

111 

IF  NRSET  <>  0 

900 

121 

CALL  FREDUCE  (  ,  [DMUF) ,  [PFOA(BC) ) ,  , 

901 

121 

[KOOINV(BC)),,,  IGSUBO(BC) ) ,  , 

902 

121 

[DMUA],  ICMUOl  >; 

903 

111 

endif; 

904 

10! 

ELSE 

905 

101 

(DPAV)  :«  [ DPFV 1 ; 

90S 

101 

IF  NRSET  <>  0  [DMUA)  [DMUF); 

907 

101 

ENDIF; 

908 

91 

ENDIF; 

909 

81$ 

$ 

910 

81 

IF  NRSET  <>  0  THEN 

911 

9! 

CALL  R0WPART  (  [DPAV),  [DPRV),  [DPLV]  ,  (PARL(BC))  >; 

912 

91 

CALL  ROWPART  (  [DMUA),  [  DMUR] ,  [DMUL] ,  [PARL(BC)  )  ); 

913 

91 

[DMU)  :»  TRANS ( [ D ( BC ) ) )  *  [DMUL)  4-  [DMUR); 

914 

91 

CALL  RCWttRGE  (  [DPI],  [DMU),  [DPLV),  [ PARL(DC) )  ); 

915 

91 

[DRHS]  TRANS (  [D(BC))  )  •  [DPLV)  4-  [DPRV); 

916 

9! 

IF  AAC  <>  0  THEN 

917 

101$ 

$ 

918 

101$ 

PROCESS  ACTIVE  CONSTRAINTS  FOR  SAERO  DISCIPLINE 

$ 

919 

101$ 

$ 

920 

101 

CALL  GFBS  (  [KLll(BC)),  [KUll(BC)],  [DPI),  [DK1V]  > 

’ 

921 

101 

[DRHS)  :«  [DRHS]  -  [K21(BC>)  »  [DK1V); 

922 

101$ 

$ 

923 

101$ 

CALL  AERO  SENS  TO 

$ 

924 

101$ 

PROCESS  ACTIVE  AERO  EFFECTIVENESS  CONSTRAINTS. 

$ 

925 

101$ 

NOTE  THAT  NAU  IS  DECREMENTED  IN  AEROSENS  TO 

$ 

926 

101$ 

ACCOUNT  FOR  PSEUDO  DISPLACEMENTS  ASSOCIATED  WITH 

$ 

927 

101$ 

AEROELASTIC  CONTROL  EFFECTIVENESS  CONSTRAINTS 

$ 

928 

101$ 

$ 

929 

10! 

CALL  AEROSENS  (BC,  TRMTYP,  MINDEX,  NDV,  NAU,  MAE, 

930 

101 

NAUE ,  PAE,  [ DK1V] ,  [DRHS],  |K1112(BC)), 

931 

101 

|K21(BC|),  [RHS(BC) ) ,  [LHS(BC)),  [PAR(BC)), 

932 

101 

[DUAV],  [PGA],  [DDE  LEW),  [AMAT]  ),' 

933 

101 

ELSE 

934 

101$ 

$ 

935 

101$ 

PROCESS  ACTIVE  CONSTRAINTS  FOR  STATICS  DISCIPLINE 

$ 

936 

101$ 

s 

937 

101 

CALL  INERTIA  (  [MRR(BC)  ) ,  [DRHS),  [DURD),  1  >; 

938 

101 

[DULD)  :»  [D(BC)I  *  [DURD); 

939 

101 

CALL  ROWMERGE  (  [DUAD),  [DURD),  [DULD),  [PARL(BC)  ) 

); 

940 

101 

(DPLV)  :«  [DPLV)  +  [IFR(BC))  *  [DURD); 

941 

101 

CALL  FBS  (  [  KLLINV  ( BC )  )  ,  [DPLV],  [DULV)  ); 

942 

101 

CALL  YSMERGE  (  [DUAV),  ,  [DULV),  [PARL(BC)  )  ); 

943 

101 

ENDIF; 

944 

9! 

ELSE 

945 

91$ 

$ 

946 

91$ 

NOTE  THAT  SAERO  W/O  SUPPORT  IS  NOT  SUPPORTED 

S 

947 

91$ 

$ 

948 

91 

CALL  FBS  (  [  KLLINV (BC) ) ,  [DPAV),  [DUAV)  ); 

949 

91 

ENDIT; 

950 

81$ 

$ 

951 

81$ 

CONTINUE  WITH  THE  RECOVERY  ONLY  IF  THERE  ARE  STILL  ACTIVE  $1 

952 

81$ 

DISPLACEMENTS.  IF  THE  ONLY  DISPLACEMENT  DEPENDENT 

$i 

953 

81$ 

CONSTRAINTS  ARE  AEROELASTIC  CONTROL  EFFECTIVENESS 

S 

954 

81$ 

CONSTRAINTS,  THEN  THERE  IS  NO  NEED  TO  CONTINUE  WITH  THE 

$ 

955 

81$ 

RECOVERY  PROCESS.  PROCEED  WITH  THE  NEXT  ACTIVE  BOUNDARY 

$ 

956 

81$ 

CONDITION. 

$ 

957 

81$ 

$ 
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MAPOL  SOURCE  CODE  LISTING 


STM 

LZVL 

958 

8! 

IT  NAU  <>  0  THEN 

95* 

91$ 

$! 

960 

9!$ 

RECOVER  TO  THE  F  SET 

$! 

961 

9!$ 

$! 

962 

9! 

CALL  NULLMAT  (  tDUTV]  )  ; 

963 

9! 

IF  NGDR  <>  0  THEN 

964 

10! 

tDUTV]  :=  (GSUBO( DC) ]  *  t DUAV ] ; 

965 

10! 

ELSE 

966 

10! 

IT  NOMIT  <>  0  THEN 

967 

11! 

IT  NRSET  <>  0  THEN 

96S 

12 1 

IT  AAC  <>  0  THEN 

969 

13! 

[TMPl]  :»  tDPOV)  +  (POARO(BC)  ]  *  { DDELDV  ] ; 

970 

13! 

ELSE 

971 

13! 

(TMPl J  tDPOV]  -  IITM(BC) ]  *  [DUAD]; 

972 

13! 

ENDIT; 

973 

121 

ELSE 

974 

12! 

ITMP1]  tDPOV]; 

975 

12! 

ENDIT; 

976 

lit 

IT  AAC  <>  0  THEN 

977 

12! 

CALL  GTBS  (  tKOOL(BC)),  tKOOU(BC)],  tTMPl], 

976 

12! 

tUOO]  ) ; 

979 

12! 

tUO]  tGASUBO(BC)]  *  [DUAV]  +  [UOOJ; 

980 

12! 

ELSE 

981 

12! 

CALL  TBS  (  ( KOOINV ( BC ) ] ,  tTMPl),  tUOO]  |; 

982 

12! 

[IK>]  :»  t GSUBO ( BC ) )  *  [DUAV]  +  tUOO]; 

983 

12t 

ENDIT; 

984 

11! 

CALL  ROWMERGE  ([DUTV],  (UO) ,  [DUAV],  [PTOA(BC)  ] ) ; 

985 

11! 

ELSE 

J 

986 

11! 

tDUTV]  :»  (DUAV); 

987 

11! 

ENDIT; 

988 

10! 

ENDIT; 

989 

9!$ 

$! 

990 

91$ 

REDUCE  THE  LEFT  HAND  SIDE  MATRIX 

$1 

991 

9!$ 

$! 

992 

9! 

IT  NMPC  <>  0  THEN 

993 

10! 

CALL  GREDUCE  ( ,  I DFDU] ,  [  PGMN(BC)  ] ,  [TMN(  BC]  ] , ,  IDTDUNJ  ] ;  1 

994 

101 

ELSE 

! 

995 

10! 

[ DFDUNJ  :*  tDTDUt; 

t 

996 

10! 

ENDIT; 

! 

997 

91$ 

$! 

998 

9! 

IT  NSPC  <>  0  THEN 

! 

999 

10! 

CALL  ROWPART  (  IDTDUNJ ,  ,  tDTDUTJ ,  tPNST(BC) ]  ); 

! 

1000 

10! 

ELSE 

! 

1001 

10! 

tor  OUT]  :«  I DTDUN] ; 

! 

1002 

10! 

ENDIT; 

! 

1003 

9!$ 

$! 

1004 

9!$ 

ACCOUNT  TOR  VIRTUAL  LOAD  METHOD 

$! 

1005 

9!S 

$! 

1006 

9! 

IT  NACSD  >  NAU  *  NOT  OR  AAC  <>  0  THEN 

! 

1007 

10!$ 

$! 

1008 

10!$ 

USE  GRADIENT  METHOD 

$! 

1009 

10!$ 

$! 

1010 

10! 

CALL  MKAMAT  UAMATJ,  I DTDUT  ] ,  tDUTV],  PCA,  [PGA]  ); 

! 

1011 

10! 

ELSE 

! 

1012 

101$ 

$! 

1013 

101$ 

USE  VIRTUAL  LOAD  METHOD 

$! 

1014 

10!$ 

$! 

1015 

10 1 

CALL  MKAMAT  (tAMAT),  tDUTV],  t  DTDUT  ] ,  PCA,  [PGA]  ); 

! 

1016 

101 

ENDIT; 

i 

1017 

9!$ 

$! 

1018 

9! 

ENDIT;  $  END  IT  ON  REMAINING  ACTIVE  APPLIED  LOADS 

$ ! 

1019 

81 

ENDIT;  $  END  IT  ON  ACTIVE  APPLIED  LOADS 

$! 

1020 

7! 

ENDIT;  $  END  IT  ON  ACTIVE  BOUNDARY  CONDITION 

$! 

1021 

6! 

ENDOO;  $  END  DO  ON  ACTIVE  BOUNDARY  CONDITIONS 

$! 
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*****  MMOL  SOURCE  CODE  LISTING  ***** 

ST  AT  LEVL 

1022  S!$ 

1023  51$  DEFINE  A  MOVE  LIMIT  IN  DESIGN: 

1024  5!$  VMIN  «  V  /  MOVLIM  OR  MINIMUM  D.V.  VALUE 

1025  51$  VMAX  «  V  *  MOVLIM  OR  MAXIMUM  D.V.  VALUE 

1026  51$  MOVLIM  GREATER  THAN  1.0 

1027  51$ 

1028  51  CALL  DESIGN!  CONVERGE,  MOVLIM,  CNVRGLIM,  CTL,  CTLMIN,  OPSTRAT, 


1029  5!  NUMOPTBC,  [AMAT)  >; 

1030  51$  $ 

1031  51  ENDIF;  $  END  ir  ON  FSDFLO  TEST  $ 

1032  41  ENDIF;  $  END  IF  TEST  AFTER  ACTCON  $ 

1033  31  ENDDO;  $  END  WHILE  LOOP  rOR  CONVERGE  S 

1034  2IENDIF;  $  END  IF  ON  OPTIMIZATION  $ 

1035  11$  $ 

1036  n$*.. ............................... 

1037  11$  BEGIN  FINAL  ANALYSIS  LOOP  $ 

1038  11$** . 

1039  11$  $ 

1040  HIT  NBNDCOND  >  NUMOPTBC  THEN 

1041  21$  $ 

1042  21$  ASSEMBLE  THE  GLOBAL  MATRICES  $ 

1043  21$  $ 

1044  2!  NEGl  :«  -1; 

1045  21  CALL  EMA2  (  GSIZE,  (KGG),  (MGG )  ); 

1046  21  FOR  BC  »  NUMOPTBC  +  1  TO  NBNDCOND  DO 


1047  31  CALL  BOUND  [BC,  NMPC,  NS  PC,  N0MIT,  NRSET,  NGDR  ) ; 

1048  31  CALL  BDCASE  (BC,  BLOAD,  BMASS,  BM0DES,  BSAERO,  QDP,  MINDEX, 

1049  31  SYM,  TRMTYP ,  BFLUTR,  BDYN,  BDRSP,  BDTR,  BMTR,  BDFR,  BMFR, 

1050  31  8GUST,  BBLAST  ); 

1051  31  IF  BLOAD  <>  0  CALL  GTL0AD  (  BC,  GSIZE,  IPG )  ) ; 

1052  31  IF  BSAERO  <>  0  THEN 

1053  41  CALL  NULXMAT  (  [AIC]  ); 

1054  41  IF  SYM  *  1  THEN 

1055  5!  [AIC)  [AI CHAT (MINDEX) 1 ; 

1056  5!  ELSE  IF  SYM  »  -1  THEN 

1057  6!  [AIC)  [ AAICMATI MINDEX ) ) ; 

1058  6!  ENDIF; 

1059  5!  ENDIF; 

1060  41  ENDIF; 


1061  31$  $1 

1062  31$  PARTITION-REDUCTION  OF  GLOBAL  MATRICES  $1 

1063  31$  $1 

1064  31  IF  NBNDCOND  >  1  CALL  NULLMAT  (  [  KNN) ,  [PN),  [MNN),  [GTKN) ,  [  GSTKN ) ,  I 

1065  4!  [UOTKN1  ) ;  I 

1066  31  IF  NMPC  <>  0  THEN  I 

1067  41$  $1 

1068  41$  PERFORM  MPC  REDUCTION  $1 

1069  41$  $1 


1070  4!  CALL  GREDUCE  (  (KGG),  (PG),  (PGMN(BC)J,  [  TMN  ( BC ) ) ,  [KNN),  [PN)  ) ; 

1071  4!  IF  BMASS  <>  0  CALL  GREDUCE  ( [MGG) , ,  [PGMN(BC) ) ,  [TMN(BC) ) ,  [MNN)); 

1072  4!  IF  BSAERO  <>  0  THEN 

1073  5!  CALL  GREDUCE  (,  (GTKG),  [PGMN(BC)  J ,  [TMN(BC) ) , ,  [GTKN)); 

1074  5!  CALL  GREDUCE  (,  (GSTKG) ,  [PGMN(  BC) ) ,  [TMN(  BC) ) , ,  [GSTKN)); 

1075  5!  ENDIF; 

1076  4!  IF  BFLUTR  <>  0  OR  BGUST  <>  0  OR  BBLAST  <>  0 

1077  5!  CALL  GREDUCE  (,  (UGTKG) ,  [ PGMN( BC) ) , [TMN( BC) ) ,  ,  [UGTKN)  ); 

1078  4!  ELSE 
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VH/>  V> 
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MAPOL  SOURCE  CODE  LISTING 


STAT 

LEVL 

1079 

4!$ 

$ 

10S0 

41$ 

NO  MFC  REDUCTION 

$ 

1081 

41$ 

$ 

1082 

41 

IKNN(  (KGG|; 

1083 

41 

IP  BLOAD  <>  0  (PN)  :»  [  PG  ] ; 

1084 

41 

IP  BMASS  <>  0  [KNNJ  :«  (MGG) ; 

1085 

41 

IP  BSAERO  <>  0  THEN 

1086 

51 

[GTKN|  :■  (GTKG); 

1087 

51 

(GSTKNI  :»  (GSTKG); 

1088 

51 

ENDIP; 

1089 

41 

IP  BrLUTR  <>  0  OR  BOUST  <>  0  OR  BBLAST  <>  0  (UGTKN)  :« 

[ UGTKG ] ; 

1090 

41 

ENDIP; 

1091 

31 

IP  NBNDCOND  >  1  CALL  NULLMAT  (  (KPP(,  (PP),  (MFF),  [GTKF), 

[ GSTKF ( , 

1092 

41 

(UGTKP )  ); 

1093 

31 

IP  NS PC  <>  0  THEN 

1094 

41$ 

$ 

1095 

41$ 

PERFORM  SPC  REDACTION 

$ 

1096 

41$ 

$ 

1097 

41 

CALL  NREDUCE  (  (KNN( ,  [PN(,  |PNSP(BC)|,  (YS(BC)I,  |KFF(, 

[KFS( , 

1098 

41 

(KSS 1 ,  (PP(  ); 

1099 

41 

IP  BMASS  <>  0  CALL  NREDUCE  (  (MW),  ,  |PNSr(BC>),  ,  [MRP)); 

1100 

41 

IP  BSAEAO  <>  0  THEN 

1101 

51 

CALL  NREDUCE  (  ,  [GTKNf,  [PNSF(BC)(,  ,  ,  ,  ,  [GTKF)  ) 

; 

1102 

51 

CALL  NREDUCE  (  ,  [GSTKNI,  [PNSP(BC)) . (OSTKP1 

); 

1103 

51 

ENDIP; 

1104 

41 

IP  BPLUTR  <>  0  OR  BOUST  <>  0  OR  BBLAST  <>  0 

1105 

51 

CALL  NREDUCE  (,  (UGTKN),  [PNSP(BC)  ( , , ,  ,  ,  [UGTKP)); 

1106 

41 

ELSE 

1107 

41$ 

$ 

1108 

41$ 

NO  SPC  REDUCTION 

$ 

1109 

41$ 

$ 

1110 

41 

[KTF[  :«  (KNN); 

1111 

41 

IP  BLOAD  <>  0  IPP)  [PN); 

1112 

41 

IP  BMASS  <>  0  (MFF[  [MNNl; 

1113 

41 

IP  BSAERO  <>  0  THEN 

1114 

51 

(GTKF)  (GTKNl; 

1115 

5! 

(GSTKF)  [GSTKN); 

1116 

51 

ENDIP; 

1117 

41 

IP  BPLUTR  <>  0  OR  BGUST  <>  0  OR  BBLAST  <>  0  [UGTKP)  :« 

(UOTKNl; 

1118 

41 

ENDIP; 

1119 

31$ 

$ 

1120 

31$ 

IP  STEADY  AERODYNAMICS  FOR  THIS  B.C.,  ADJUST  THE  KFF  MATRIX 

$ 

1121 

31$ 

$ 

1122 

31 

IP  BSAERO  <>  0  THEN 

1123 

41 

CALL  TRNSPOSE  (  (GSTKF [ ,  IGSKTl  ); 

1124 

41 

(AICS )  (GTKP1  *  l  TRANSf  [AIC( >  *  (GSKP)  |f 

1125 

41 

(PAP(  (QDP )  (  [GTKF (  »  [AIRTRC(MINDEX)  ]  ); 

1126 

41 

(KAPP)  ;»  (KFF]  -  (QDP)  (AICS); 

1127 

41 

ENDIP; 

1128 

31$ 

$ 

1129 

31 

IP  NBNDCOND  >  1  CALL  NULLMAT  ( [  KAA]  ,  (PA),  (MAA),  [KAAA| ,  |PAA|,  |UGTKA();1 

1130 

31 

IP  NGDR  <>  0  THEN 

1131 

41$ 

$1 

1132 

41$ 

PERFORM  THE  GENERAL  DYNAMIC  REDUCTION 

$ 

1133 

41$ 

$1 

1134 

41 

IT  NOKIT  <>  0  OR  NRSET  <>  0  THEN 

1135 

51$ 

$1 

1136 

51$ 

OBTAIN  THE  OMITTED  OOP  PARTITION  OP  KFF  AND  MPP 

$1 

1137 

51$ 

$1 

1138 

51 

CALL  PARTN  (  (KTri,  (KOOl,  ,  (KOA),  ,  (PrOA(BC)(  ); 

1139 

51 

CALL  PARTN  (  (MFF(,  (MOOf,  ,  ,  ,  (PFOA(BC)I  ); 

I 


I 


« 


« 


« 


9 


« 
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MAPOL  SOURCE  CODE  LISTING 


STAT 

1140 

LEVL 

51 

ELSE 

1141 

5! 

(KOO)  (KFF]; 

1142 

51 

[MOO]  :»  (KTF ) 1 

1143 

51 

ENDIF; 

1144 

41 

CALL  GDR1  ([KOO],  [MOO],  [KSOO],  [GGO] ,  LKSET,  LJSET,  NEIV,  FMAX, 

BC);  1 

1145 

41$ 

$1 

1146 

41$ 

LKSET  MEANING 

$1 

1147 

41$ 

<>  0  K-SET  EXISTS 

$1 

1148 

41$ 

-  0  K-SET  DOES  NOT  EXIST 

$1 

1149 

41$ 

$1 

1150 

41 

IF  LKSET  <>  0  THEN 

1151 

51 

CALL  SDCOMP  (  [KSOO],  [LSOO]  ),* 

1152 

51 

CALL  GDR2  (  [LSOO],  (MOO),  [PHIOK),  LKSET,  L7SET,  NEIV,  FMAX, 

BC) ;  1 

1153 

51 

ENDIF; 

1154 

4! 

CALL  ODR3  (  [KOO],  [KOA],  [MGG] ,  [PHIOK],  (TMN(BC)  ] ,  [OGO], 

1155 

4! 

(PGMN(BC) ] ,  [PNSF(BC) ] ,  [PFOA(BC)), 

1156 

4! 

(GSllBO(BC)  ] ,  LKSET,  L3SET,  NOMIT,  NRSET,  GNORM,  BC  ) ; 

1157 

41 

CALL  GDR4  (  BC,  OSIZE,  GSIZEN,  LKSET,  LJSET,  NUMOFTBC, 

1158 

4! 

NBNDCOND,  (GDRGO(BC) ) ,  ,  ,  ,  ,  ,  (PARL(BC) )  ); 

1159 

41$ 

$1 

1160 

4! 

[MAA]  :»  TRANS  (  [GSUBO(BC))  )  *  I  [MFF]  *  [GSUBO(BC)]  ); 

1161 

4  I 

[KAA]  TRANS  (  (GSUBO(BC))  )  *  [  [KFF]  *  [GSUBO(BC)J  ); 

1162 

4  ! 

IF  BLOAD  <>  0  [PA]  :>  TRANS  (  (GSUBO(BC))  )  *  (PF); 

1163 

4! 

IF  BFLUTR  <>  0  OR  BGUST  <>  0  OR  BBLAST  <>  0  THEN 

1164 

51 

[TMP1]  :»  TRANS  (  [UGTKF]  )  *  [ OSUBO ( BC )  ) ; 

1165 

51 

CALL  TENS  POSE  (  [TKP1],  (UGTKA)  ); 

1166 

51 

ENDIF; 

1167 

4! 

ELSE 

1168 

4! 

IF  NOMIT  <»  0  THEN 

1169 

51$ 

$1 

1170 

51$ 

PERFORM  THE  STATIC  REDUCTION 

$1 

1171 

51$ 

$1 

1172 

51 

ir  BSAERO  <>  0  THEN 

1173 

6! 

IF  BLOAD  -  0  THEN 

1174 

71$ 

$1 

1175 

71$ 

FORM  [KAA]  SO  [D]  CAN  BE  FORMED 

$1 

1176 

71$ 

$1 

1177 

71 

CALL  FREDUCE  ([KFF],  ,  [PFQA(BC)],  ,  [ KOOINV ( BC ) ] ,  ,  , 

1178 

71 

(GSUBO(BC) ] ,  [KAA]  )} 

1179 

71 

ENDIF; 

1180 

61 

CALL  FREDUCE  (  [KAFF],  [PAF] ,  [PFOA(BC)],  BSAERO,  [KOOL(BC)] 

»  • 

1181 

61 

(KOOU(BC)),  [KAO(BC) ) ,  ( GASUBO ( BC ) ] ,  [KAAA] , 

1182 

61 

[PAA],  [ POARO ( BC ) ]  )? 

1183 

61$ 

$1 

1184 

61$ 

PERFORM  GUY  AN  REDUCTION  OF  THE  MASS  MATRIX 

$1 

1185 

61$ 

$1 

1186 

61 

IF  BMASS  <>  0  THEN 

1187 

71 

CALL  PARTN  (  [MFT) ,  [MOO],  ,  [MOA] ,  [MAABAR],  [PFOA(BC)] 

);  i 

1188 

7! 

[MAA]  :»  [MAABAR]  +  TRANS (  | MOA ] )  *  [ GASUBO ( BC )  ]  + 

1189 

7! 

TRANS ( (GASUBO (BC) ] )  *  [MOA]  ♦ 

1190 

71 

TRANS  (  [ GASUBO ( BC ) ) )  *  [  [MOO]  *  [ GASUBO ( BC )  ]  ] ; 

1191 

7! 

IF  NRSET  <>  0  ( IFM(BC)  )  :=  (MOO)  *  [  GASUBO  (BC) )  +  [MOA]; 

1192 

7! 

ENDIF; 

1193 

61 

ELSE 

1194 

6! 

CALL  FREDUCE  (  [KFF],  (PF),  [PFOA(BC)),  ,  ( KOOINV (BC) ] ,  ,  , 

1195 

6! 

(GSUBO(BC)),  [KAA],  [PA],  [PO]  ); 

1196 

61$ 

$i 

1197 

61$ 

PERFORM  GUY AN  REDUCTION  OF  THE  MASS  MATRIX 

$i 

1198 

61$ 

$i 

Figure  C. 1  Standard  MAPOL  Sequence  (Continued) 


MAPOL  SWIRCE  CODE  LISTING 


STAX 

1199 

LEVL 

61 

IF  BMASS  <>  0  THEN 

1200 

7! 

CALL  PARTN  (  [MFFJ ,  )HOO),  ,  1MOA1 ,  (MAABAR),  ]PFOA(BC)]  ); 

1201 

7! 

[MAA]  (MAABAR1  +  TRANS!  [NOA] )  *  [GSUBO(BC)[  + 

1202 

7! 

TRANS ( [ GSUBO ( BC )  ] )  *  ]MOA)  + 

1203 

7! 

TRANS! lOSUBO(BC) 1)  *  ]  (MOO)  *  [ GSUBO (BC) 1  ]; 

1204 

71 

IF  NRSET  <>  0  1 IFM(BC) [  1MOO)  *  ]GSUBO(BC)]  ♦  JMQA1; 

1205 

7! 

ENDIF; 

1206 

6! 

ENDIF; 

1207 

5! 

IF  BFLUTR  <>  0  OR  BGUST  <>  0  OR  BBLAST  <>  0  THEN 

1208 

61 

CALL  RCMPART  ( [UGTKF1 ,  [UGTKO],  ]UGTKAB),  )PFOA(BC)[); 

1209 

6! 

[TMP1  ]  TRANS!  [UGTKO]  )  *  [GSUBO(BC)]; 

1210 

6! 

CALL  TRNSPOSE  (  (TMP11,  ]TMP2)  ); 

1211 

61 

1UGTKA]  [UGTKAB]  ♦  ]TMP2[; 

1212 

61 

ENDIF; 

1213 

51 

ELSE 

1214 

51$ 

$1 

1215 

5IS 

NO  F-SET  REDUCTION 

$1 

1216 

51$ 

$1 

1217 

SI 

1KAA)  1KFFI; 

1218 

SI 

IF  BLOAD  <>  0  JPA]  :■  [PF1; 

1219 

51 

IF  BSAERO  <>  0  THEN 

1220 

61 

I KAAA]  :»  )  KAFF ] ; 

1221 

61 

1PAA1  (PAF1; 

1222 

61 

ENDIF; 

1223 

SI 

IF  BFLUTR  <>  0  OR  BGUST  <>  0  OR  BBLAST  <>  0  [UGTKA]  [UGTKF] ; 

1224 

SI 

IF  BMASS  <>  0  ]MAA]  :»  [ MFF [ ; 

1225 

51 

ENDIF; 

1226 

41 

ENDIF; 

1227 

31 

IF  NRSET  <>  0  THEN 

1228 

41$ 

$1 

1229 

41$ 

PERFORM  THE  SUPPORT  SET  REDUCTION 

$1 

1230 

41$ 

$1 

1231 

41 

CALL  PARTN  (  ]KAA],  ,  ]  KLR]  ,  ,  ]KLL]  ,  )PARL(BC)]  (; 

1232 

41 

CALL  SDCOMP  (  ]KLL] ,  ]KLLINV(BC)]  ); 

1233 

41 

CALL  FBS  (  [KLLINV(BC)  ]  ,  [KLR[,  ]D(BC)],  NEG1  )J 

1234 

41$ 

$1 

1235 

41$ 

CALCULATE  THE  REDUCED  MASS  MATRIX 

$1 

1236 

41$ 

$1 

1237 

41 

CALL  PARTN  ( [MAA] ,  [MRRBAR]  ,  (MLR),  ,  )MLL],  [PARL(BC)]); 

1238 

41 

JIFR(BC) 1  (MLL1  •  ]D(BC) )  ♦  ]MLR] ; 

1239 

41 

IMRR(BC)  1  :■  [MRRBAR]  +  TRANS  (  [MLR]  )  •  ]D(BC)]  + 

1240 

41 

TRANS  (  ]D(BC) )  )  •  [irR(BC)]; 

1241 

41 

[R22]  :«  TRANS  (  (D(BC)l  )  •  1HLR]  +  [MRRBAR]; 

1242 

41 

CALL  TRNSPOSE  (  JIFR(BC)],  ]R21[  ); 

1243 

41 

IF  BSAERO  <>  0  THEN 

1244 

51$ 

$1 

1245 

51$ 

PROCESS  STEADY  AEROELASTIC  DISCIPLINE 

$1 

1246 

51$ 

$1 

1247 

51 

CALL  PARTN  (  [KAAA],  [KARR],  [KALR] ,  [KARL],  [KALLJ,  ]  PARL(BC) )  ); 

1248 

51 

(R321  :»  TRANS!  ] D< BC )  ] )  •  [KALR]  +  [KARRI; 

1249 

51 

[R31 )  TRANS!  [D(BC)  |)  •  [KALL]  +  [KARL]; 

1250 

51 

CALL  MERGE  (  [Kll],  ]  R22  ]  ,  [KALR],  [R21],  [KALL),  IPARL(BC)  ]  ); 

1251 

51 

CALL  RCMPART  (  ]  PAA]  ,  [PARBAR],  [PAL],  [PARL(BC)  ]  ); 

1252 

51 

CALL  YSMERGE  (  [PI],  ,  [PAL],  [PARL(BC)  ]  ); 

1253 

SI 

CALL  YSMERGE  (  ]  K12  ( BC  )  | ,  ,  [IFRIBCI],  [PARL(BC) )  ); 

1254 

SI 

CALL  COLMERGE  (  ]K21(BC)[  ,  [R32],  [R31],  [  PARL(BC)  ]  ); 

1255 

SI 

CALL  DECOMP  (  [Kll],  [KLll(BC)],  [KUll(BC)]  ); 

1256 

51 

CALL  GFBS  < ] KL1 1 ( BC ) 1 ,  [KUll(BC)],  )K12(BC)[,  ]K1112(BC)[,  NEG1 ) ; 

1257 

51 

CALL  GFBS  ( ] KL1 1 ( BC ) ] ,  [KUll(BC)],  [PI],  )PAR(BC)[  ); 

1258 

51 

]LHS(BC)[  :«  ]MRR(BC) ]  +  [K21 (BC) )  •  )K1112(BC)[; 

1259 

SI 

I P2 ]  (PARBAR]  *  TRANS! ]D(BC) [ )  *  [PAL]; 

1260 

51 

(RHS(BC)l  :»  ]P2]  -  [K21(BC)[  •  ]PAR(BC)[; 

Figure  C. 1  Standard  MAPOL  Sequence  (Continued) 
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MAPOL  SOURCE  CODE  LISTING 


STAT  LEVL 

1261  51 

1262  51 

1263  51 

1264  61 

1265  61 

1266  61 

1267  6! 

1268  61 

1269  51 

1270  41$ 

1271  4! 

1272  51$ 

1273  51$ 

1274  51$ 

1275  51 

1276  51 

1277  5! 

1278  51 

1279  51 

1280  51 

1281  SI 

1282  51 

1283  SI 

1284  SI 

1285  51 

1286  51 

1287  51 

1288  SI 

1289  51 

1290  4! 

1291  S! 

1292  4! 

1293  41$ 

1294  41$ 

1295  41$ 

1296  41 

1297  51 

1298  51 

1299  51 

1300  41 

1301  51$ 

1302  51$ 

1303  51$ 

1304  5! 

1305  5! 

1306  51 

1307  41 

1308  51 

1309  41 

1310  3 ! $ 

1311  31$ 

1312  31$ 

1313  3!$ 

1314  3! 

1315  4! 

1316  41 

1317  41 

1318  4! 

1319  41 


CALL  SAERO  (  BC,  [IHS(BC)],  (RHS(BC)l,  |AR) ,  (DELTA), 
[P21,  (HRR(BC)l); 
ir  TRHTYP  >  0  THEN 

(AL|  (D(BC)l  *  (AR); 

CALL  ROMEROS  (  (AA),  (AR),  (AL) ,  (PARL(BC)I  ),’ 

(UA)  (K1112  (BC)  ]  *  ( AR)  +  (PAR(BC))  *  (DELTA); 

ir  NOM1T  <>  0  |PO)  :«  (POARO(BC))  *  (DELTA)  ; 

ENDIF; 

ENDIF; 


IF  BLOAD  <>  0  THEN 


PROCESS  STATICS  WITH  INERTIA  RELIEF 


CALL  MERGE  (  (Kill,  (R22),  (KLR),  (R21),  (KLL)  ,  (PARL(BC) )  ); 
CALL  YSMERGE  (  (PI),  ,  (PLBAR),  (PARL(BC) )  ); 

CALL  YSMERGE  (  (K12(BC)1,  ,  (IFTMBC)],  (PARL(BC)  )  ); 

CALL  DECOMP  (  (Kll),  (KUl(BC)),  (KUll(BC))  ); 

(PI  1  :m  (Pi)  -  ( K12 ( BC ) ]  *  (AR); 

CALL  GFBS  (  (KLll(BC)),  (KUll(BC)),  (PI),  (UA) ,  NEG1  ); 
(LHS(BC) ]  :«  [ MRR ( BC ) ] ; 

CALL  ROWPART  <  (PA),  (PR),  (PLBAR),  (PARL(BC) )  ); 

(RHS(BC)l  :»  TRANS (  ( D ( BC ) 1  )  *  (PLBAR)  +  (PR); 

CALL  INERTIA  ((WS(BC)],  (RHS(BC)),  (AR)  ); 

(AL)  :«  (D(BC)l  *  (AR1 ; 

CALL  ROMERGE  (  (AA),  (AR),  (AL) ,  (PARL(BC) )  ); 

[Pll  (PI)  -  (K12(BC)1  •  (AR); 

CALL  GFBS  (  ( KL1 1  ] ,  (KU11),  (PI),  (UA)  ); 

ENDIF; 

IF  BMODES  <>  0  CALL  REIG  (  BC,  (KAA),  (MAA),  (MRR(BC)),  [  D(  BC ) ) , 

LAMBDA,  (PHIA),  (Mil),  HSIZE); 


ELSE 


NO  SUPPORT  SET  REDUCTION 

IF  BLOAD  <>  0  THEN 

CALL  SDCOMP  (  (KAA],  1 KLLINV ( BC)  ]  ); 
CALL  FBS  (  [  KLLINV  ( BC ) ) ,  (PA),  (UA)  ); 
ENDIF; 

IF  BSAERO  <)  0  THEN 


NOT  FUNCTIONAL,  REQUIRES  [DELTA]  TO  BE  INPUT 


CALL  DECOMP  (  (KAAA) ,  (KLLL(BC) ) ,  (KLLU(BC)  ]  ); 

CALL  GFBS  (  (KLLL(BC) ) ,  (KLLU(BC)  ] ,  (PAA),  (UA)  ),* 

ENDIF; 

IF  BMODES  <>  0  CALL  REIG  (  BC,  (KAA),  (MAA),,,  LAMBDA,  (PHIA), 

[Mil],  HSIZE  ); 


ENDIF; 


PERFORM  ANY  DYNAMIC  ANALYSES  —  NOTE  THAT  THESE  ARE  INDEPENDENT 
OF  THE  SUPPORT  SET 

IF  BDYN  <>  0  THEN 

CALL  QHHLGEN  (BC,  ( QKKL  ] ,  [QKJL] ,  (UGTKA) ,  (PHIA), 

(PHIKHJ,  (QHHL(BC) ),  (QHJLI ) ; 

CALL  DMA  (  BC,  GSIZE,  (MAA),  (KAA),  (TMN(BC) ) ,  (GSUBO(BC)),  NGDR, 
LAMBDA,  (PHIA),  (MDD),  [ BDD ) ,  (KDDT),  | KDDF ) , 

(MHH(BC)l,  [ BHH ] ,  (KHHT) ,  (KHHF(BC)]  ); 


$ 

$ 

$ 

$ 


$ 

$ 

$ 


$ 

$ 

$ 


$ 

$ 

$ 

$ 


« 


i 


« 


« 


i 


i 


9 


| 
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MAPOL  SOURCE  CODE  LISTING 


STAX  LEVL 

1320  41 

1321  41 

1322  41 

1323  SI 

1324  41 

1325  SI 

1326  SI 

1327  51 

132*  SI 

1329  SI 

1330  SI 

1331  SI 

1332  41 

1333  31 

1334  41 

1335  41 

1336  41 

1337  41 

133*  41 

1339  41 

1340  41 

1341  41 

1342  41 

1343  41 

1344  41 

1345  41 

1346  41 

1347  41 

134*  41 

1349  41 

1350  41 

1351  4! 

1352  41 

1353  4! 

1354  41 

1355  4 1 

1356  41 

1357  41 

1356  4! 

1359  4! 

1360  4! 

1361  31$ 

1362  31$ 

1363  31$ 

1364  31 

1365  3! 

1366  41$ 

1367  41$ 

1364  41$ 

1369  4! 

1370  51 

1371  51 

1372  51 

1373  41 

1374  51 

1375  51 

1376  51 

1377  41 

1374  41 

1379  41 

1340  41 


CALL  DYWLQAD  (  BC,  GSIZE,  (TMN(BC)l,  (GSUBO(BC)),  NGDR, 

[PHIA] ,  (QHJL),  [PDT] ,  |PDT]  ); 

IP  BPLUTR  <>  0  CALL  PUfTTRAN  [BC,  [QHHL(BC) ) ,  LAMBDA,  KSIZE, 

(MOt (BC)  ] ,  [ KHHF( BC)  ] ) ; 

IF  BDRSP  <>  0  THEN 

CALL  DYNRSP  (BC,  [MDD],  ( BDD] ,  (KDCT) ,  (KDDP) ,  (M<H(BC)],  (BHH) , 
[KHHT],  (KHHr(BC)l,  [PDT),  [PDP1,  (QHHL(BC) ) , 
(UTRANAI,  [  UPREQA  ] ,  (UTRANI),  [UTREQU,  (UTRANE) , 
(UTREQE)  ); 

IF  BOTH  <>  0  [UTRANA]  :■  (PHIA)  *  (UTRANI]; 

IP  BMPR  <>  0  (UPREQA)  :=  (PIIIA1  *  (UFREQI); 

ENDir; 


ENDir; 


IF  BBLAST  <>  0  THEN 

CALL  BLASTFIT  (  BC,  [QJJL],  [HATTR],  (MATSS),  BQDP,  (BFRC), 
(DWNWSH),  HSIZE,  (ID2),  (HP ART) ,  [ UGTKAJ , 
[BLGTJA],  [BLSTJA]  ); 

CALL  COLPART  (  (PHIA),  ,  (PHIE),  [HP ART]  ); 

CALL  ROWBROE  (  (PHIR),  (ID2),  [D(BC)|,  [PARL(BC)  )  ); 

CALL  COLMERGE  (  (PHIB),  (PHIR),  [PHIE],  IMPART]  |; 

[GENM]  :»  TRANS [  [PHIB]  )  *  (  (MAA)  *  (PHIB)  ); 

(GEMK)  :»  TRANS!  [PHIB]  )  *  [  [ KAA)  *  [PHIB]  ]; 

[DTSLP]  :»  TRANS  (  (BLSTJA]  )  *  (PHIB); 

(FTP)  TRANS  [  (PHIB)  )  *  [BLGTJA]; 

(GENF)  :»  (BQDP)  [PTF]  *  (BFRC); 

(GENTA)  (BQDP)  [FTP]  *  (MATSS); 

(GENQ)  :»  [GENFA]  •  (DTSLP); 

(GENQL)  :»  (BQDP)  [FTP]  *  (HATTR) ; 

CALL  PARTN  (  (GENQ) ,  (QRR)  ,  ,  [QRE ] ,  (QEE) ,  IMPART]  ); 

CALL  PARTN  (  (GENK)  ,  ,  ,  ,  (KEE),  [MPART]  ); 

(KEQE)  (QEE)  +  (KEE); 

CALL  DECOMP  (  (KEQE),  (LKQ] ,  (UKQ)  (; 

CALL  RCMPART  (  (GENF),  [GFR] ,  (GFE) ,  [MPART]  ); 

CALL  GFBS  (  (LKQ),  (UKQ),  (GFE),  (STEM)  ); 

(DELM)  !■  -[QRE]  *  [BTEM]  ♦  [ GFR ) ; 

CALL  BLASTRIM  (  BC,  (DELM) ,  (MRR(BC)  ] ,  (URDB),  (DELS)  )  ; 

(ELAS)  :•  (BTEM)  •  (DELHI; 

(SLPMOD)  :■  TRANS  (  (BLSTJA)  )  *  [PHIE]; 

CALL  BLASTDRV  (  BC,  (GEIW),  [GENK),  (GENFA),  [GENQL],  [DELB], 

(URDB),  (DWNWSH),  (rLPMrvc),  (ELAS) ,  [UBLASTI]  )  ; 


ENDIF; 


BEGIN  THE  DATA  RECOVERY  OPERATIONS 

IF  NBNDCOND  >  1  CALL  NUUMAT  (  (UW,  (AF),  \'PHIF]  ); 
IF  NGDR  <>  0  THEN 


DATA  RECOVER!  WITH  GDR 

IF  BLOAD  <»  0  THEN 

(UTJ  :»  (GSUBO[BCI)  •  (UA); 

IF  NRSET  <>  0  (AF|  :»  (OSUBO(BC))  •  (AA); 

ENDir; 

IF  BSAERO  <>  0  AND  TRMTYP  >  0  THEN 
(UP)  (GSUBQ(BC)l  •  (UA); 

IF  NRSET  <>  0  (AF)  :»  (GSUBO(BC))  *  [AA]; 

ENDir; 

ir  eMCDEC  <>  0  (PHIF|  :»  [GSUBOlff^l )  •  (v*HIA); 

IT  8DTR  <;  0  OR  BMTR  <>  0  (OSS-'OiNr)  :■  il»5U80(BC))  *  (UTRANA); 

IF  EDTR  <V  0  OR  BMFR  <>  0  (Uft^P)  ;«=  [G5V3JO(BCI  )  *  (UFREQA) : 

ELSE 


$ 

$ 

$ 


$ 

$ 

$ 


Figure  C.  1  Standard  MAP0I,  Sequence  (Continued) 
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MAPOL  SOURCE  CODE  LISTING 


STAT 

LEVL 

1381 

41 

1382 

51 

1383 

51 

1384 

51 

138$ 

5! 

1386 

61 

1387 

61 

1388 

61 

1389 

71 

1390 

6! 

1391 

51 

1392 

61 

1393 

61 

1394 

61 

1395 

61 

1396 

7! 

1397 

61 

1398 

51 

1399 

61 

1400 

61 

1401 

6! 

1402 

51 

1403 

61 

1404 

61 

1405 

61 

1406 

51 

1407 

6! 

1408 

61 

1409 

61 

1410 

5! 

1411 

5! 

1412 

51 

1413 

51 

1414 

5! 

1415 

61 

1416 

6! 

1417 

61 

1418 

5! 

1419 

61 

1420 

61 

1421 

6! 

1422 

5! 

1423 

51 

1424 

5! 

1425 

5! 

1426 

4! 

1427 

3! 

1428 

31 

1429 

31 

1430 

4! 

1431 

41 

1432 

4! 

1433 

4! 

1434 

5! 

1435 

51 

1436 

5! 

1437 

4! 

1438 

5! 

1439 

5! 

1440 

5! 

IT  NOMIT  <>  0  THEN 

DATA  RECOVERY  WITH  STATIC  CONDENSATION 
IF  BLOAC  <>  0  THEN 

CALL  RECOVA  (  (UA] ,  [PO],  (GSUBO(BC)  ] ,  NRSET,  |AA) , 

(IFN(BC)l,  ,  [KOOINV(BC)),,tPFOA[BC)),  |UF)  ); 
IT  NRSET  <>  0  CALL  RECOVA  I  [  AA) ,  ,  (GSUBO(BC) , 

[PrOAtBC)),  CAP)  >; 

ENDIF; 

IT  BSAERO  <>  0  AND  TRHTYP  >  0  THEN 

CALL  RECOVA  (  [UA],  IPO],  (GASUBOIBC)),  NRSET,  (AA) , 

I IFM( BC) ] ,  BSAERO,  (KOOL(BC) ] ,  (KOOU(BC)], 
[PFOAIBC]],  |UF]  ); 

IF  NRSET  <>  0  CALL  RECOVA  (  [AA] ,,  (GASUBOI  BC) ),,,,,, , 

[PFOAtBC)),  (AF)),‘ 

ENDIF; 

IF  BMODES  <>  0  THEN 

(PHIO]  [GSUBO(BC) ]  *  [PHIA]; 

CALL  ROWKERGE  (  (PHIF),  [PHIO],  [PHIA],  (PFOA(BC))  ); 

ENDIF; 

IF  BDTR  <>  0  OR  BMTR  <>  0  THEN 

CALL  RECOVA  (  [UTRAKA],  ,  [GSUBOI  BC)  ),,,,,, , 

[PFOA(BCI),  [UTRANF 1  ); 

ENDIF; 

IF  BDFR  <>  0  OR  BMFR  <>  0  THEN 

CALL  RECOVA  (  [ UFREQA I ,  ,  [GSUBOI BC)  ],,,,,, , 

(PFOA(BC)],  [UPREQF)  ); 

ENDIF; 

ELSE 

DATA  RECOVERY  WITHOUT  F-SET  REDUCTION 


IF  BLOAD  <>  0  THEN 
[UF]  [UA1; 

IF  NRSET  <>  0  ( AF )  :=  [AA] ; 

ENDIF ; 

IF  BSAERO  <>  0  AND  TRMTYP  >  0  THEN 
[UF]  :=  [UA]; 

IF  NRSET  <>  0  [AF]  :=  [AA); 

ENDIF; 

IF  BMODES  <>  0  [PHIF]  :«  (PHIA); 

IF  BDTR  <>  0  OR  BMTR  <>  0  [UTRANF] 

IF  BDFR  <>  0  OR  BMFR  <>  0  [UFREQF] 

ENDIF; 

ENDIF; 


[UTRANA]; 

[UFREQA]; 


IF  NBNDCOND  >  1  CALL  NULU1AT  (  [UN],  [AN],  [PHIN]  ); 

IF  NSPC  <>  0  THEN 

DATA  RECOVERY  WITH  SPC-REDUCTION 

IF  BLOAD  <>  0  THEN 

CALL  YSKERGE  I  [UN],  [YS(BC)I,  [UF],  (PNSF(BC))  ) ; 

IF  NRSET  <>  0  CALL  YSMERGE  (  [AN],  ,  [AF],  (PNSF(BC))  ) ; 
ENDIF; 

IF  BSAERO  <>  0  AND  TRMTYP  >  0  THEN 

CALL  YSMERGE  I  [UN],  [YSIBCJ],  [UF],  (PNSF(BC))  ); 

IF  NRSET  <>  0  CALL  YSMERGE  (  [AN],  ,  [AT],  (PNSF(BC)]  ); 
ENDIF; 


Figure  C.  1  Standard  MAPOI,  Sequence  (Continued) 


227 


MAPOL  SOURCE  CODE  LISTING 


STMT 

LEVL 

1441 

4! 

IF  BMODCS  <>  0  CALL  YSMERGE  (  (PHIN),  (YS(BCI),  IPHIF), 

1442 

5! 

trasr<BC)i  ): 

1443 

41 

IF  BDTR  <>  0  OR  BWTR  <>  0 

1444 

St 

CALL  YSMERGE  (  [UTRANN),  |YS(BC>),  (UTRANFJ 

1445 

51 

(PNSr<BC>),  BDTR  ); 

1446 

41 

IF  BDTR  <>  0  OR  BMFR  <>  0 

1447 

51 

CALL  YSMERGE  (  (UFREQN),  (YS(BC)l,  (UFREQF] 

1444 

51 

(  PttSF(BC)  ) ,  BDTR  ); 

1449 

41 

ELSE 

1450 

41$ 

1451 

41$ 

DATA  RECOVERY  WITHOUT  SPC-REDUCTION 

1452 

41$ 

1453 

41 

IF  BLOAD  <>  0  THEN 

1454 

St 

(UB)  JOFI ; 

1455 

St 

IF  NRSET  <>  0  (AM)  s-  (AF); 

1456 

51 

ENDIF; 

1457 

41 

IF  B3AERO  <>  0  AND  TRMTYP  >  0  THEN 

1456 

St 

(UN)  (UF); 

1459 

51 

IF  NRSET  <>  0  (AN)  :•  (AF); 

1460 

51 

ENDIF; 

1461 

41 

IF  BMODCS  <>  0  (PHIN)  (PHIF); 

1462 

41 

ir  BDTR  <>  0  OR  BMTR  <>  0  (UTRANN)  (UTRANA); 

1463 

41 

IF  BDFR  <>  0  OR  BMFR  <>  0  (UFREQN)  :c  ( UFREQA 1 ; 

1464 

41 

ENDir; 

1465 

31$ 

1466 

31 

i  r 

NBNDCOND  >  1  CALL  NULLMAT  (  (UG(BC) ) ,  (AG(BC) ) ,  (PHIG(BC)) 

1467 

31 

i  r 

IWPC  <>  0  THEN 

1466 

41$ 

1469 

41$ 

DATA  RECOVERY  WITH  MPC-REDUCTION 

1470 

41$ 

1471 

41 

IF  BLOAD  <>  0  THEN 

1472 

51 

(UMJ  (TNI(BC)  |  *  (UN); 

1473 

51 

CALL  ROWMERGE  (  (UG(BC)I,  (UM),  (UNI,  [  PGMN(BC) )  I; 

1474 

SI 

IF  NRSET  <>  0  THEN 

1475 

6 1 

(UM)  s-  (TMN(BC) )  *  (AN); 

1476 

61 

CALL  ROWKERGE  (  (AG(BC)),  (UM),  (AN),  [ PGMN(BC) )  ); 

1477 

61 

ENDIF; 

1478 

51 

ENDIF; 

1479 

41 

IF  BSAERO  <)  0  AND  TRMTYP  >  0  THEN 

1480 

51 

(UM)  (TMN(BC)  ]  *  (UN); 

1481 

51 

CALL  FCWMERGE  (  (UG(BC)),  (UM),  |UN),  [  PGMN(BC)  )  ); 

1482 

51 

IF  NRSET  <>  0  THEN 

1483 

61 

(UM)  (TMV(BC) )  *  (AN); 

1484 

6l 

CALL  RCWMERGE  (  (AG(BC)  ] ,  (UM),  (AN),  (PGMN(BC))  ); 

1485 

61 

ENDIF; 

1486 

Si 

ENDIF; 

1487 

41 

IF  BMODCS  <>  0  THEN 

1488 

51 

(UM)  (TMI(BC)l  *  (PHIN); 

1489 

51 

CALL  RCWMERGE  (  (PHIG(BC)J,  (UM),  (PHIN),  (PGMN(BC))  )  ; 

1490 

51 

ENDIF; 

1491 

41 

IF  BDTR  <>  0  OR  BMTR  <>  0  THEN 

1492 

51 

(UM)  :«  (TMN(BC))  *  (UTRANN); 

1493 

51 

CALL  RCMMERGE  (  (UTRANO),  (UM),  [UTRANN],  (PGMN(BC) )  )  ; 

1494 

St 

ENDIF; 

1495 

41 

IF  BDFR  <>  0  OR  BMFR  <>  0  THEN 

1496 

51 

(UM)  :»  (TMN(BC)I  •  (UFREQN); 

1497 

St 

CALL  RCWMERGE  (  (UFREQG),  (UM),  [UFREQN],  (PGKN(BC))  )  ; 

1498 

51 

ENDIF; 

1499 

41 

ELSE 

Figure  C. 1 


Standard  MAPOl, 


Sequence 


(Cont  inued) 
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MAPOL  source  code  listing 


STAT 

1S00 

LEVL 

41$ 

$1 

1501 

41$ 

DATA  RECOVERY  WITHOUT  MPC-REDUCTION 

$1 

1502 

4!$ 

$1 

1503 

41 

IF  BLOAD  <>  0  THEN 

1504 

5! 

(UG(8C))  (UN); 

1505 

5! 

IF  NRSET  <>  0  (AG(BC)]  (AN]; 

1506 

51 

ENDIF; 

1507 

4! 

IF  BSAERO  <)  0  AND  TRMTYP  >  0  THEN 

1508 

51 

(UG(BC) ]  [UN]; 

1509 

51 

I  NRSET  <>  0  (AG(BC)]  [AN]; 

1510 

51 

ENDIF; 

1511 

4  1 

IF  BMODES  <>  0  (PHIG(BC) ]  :»  [PHIN]; 

1512 

4! 

IF  BOTH  <>  0  OR  BMTR  <>  0  [UTRANG]  :«  [UTRANN]; 

1513 

4! 

IF  BDFR  <>  0  OR  BMTR  <>  0  [UFREQG]  [ UFREQN ) ; 

1514 

4! 

ENDIF; 

1515 

31$ 

$1 

1516 

31$ 

RECOVER  PHYSICAL  BLAST  DISCIPLINE  DISPLACEMENTS 

$1 

1517 

31$ 

$1 

1518 

3! 

IT  BBLAST  o  0  IUBLASTG]  :»  (PHIG(BC)]  *  (UBLASTI); 

1519 

31$ 

$1 

1520 

31$ 

HANDLE  OUTPUT  REQUESTS 

$! 

1521 

31$ 

$1 

1522 

31 

CALL  OFFLOAD  (  NUMOFTBC,  BC,  ,  GSIZE,  IPG) ,  TRMTYP,  QDP, 

1523 

3! 

( GTKG  ] ,  [AIRFRC(MINDEX)  ],  [DELTA]  ); 

1524 

3! 

CALL  OFPDISP  (  NUMOPTBC,  BC,  NITER,  GSIZE,  [UG(BC)],  (AG(BC) ) , 

1525 

3! 

TRMTYP,  (UG(BC)),  [AG(BC»],  [UBLASTG] ,  ,  [UTRANG], 

1526 

3! 

(UTRANE],  [UFREQG],  [UFREQE]  ,  LAMBDA,  (PHIG(BC)]  )  ; 

1527 

31 

CALL  EDR  (  NUMOPTBC,  BC,  ,  NDV,  GSIZE,  EOSUWIRY,  EODISC, 

1528 

3! 

[ UG ( BC ) ] ,  (UG(BC) ] ,  ,  [UTRANG],  [UFREQG) ,  [PHIG(BC)]  ); 

1529 

3! 

CALL  OFPEDR  (  BC,  HSIZE,  ,  TRMTYP  ); 

1530 

3!  ENDDO; 

1531 

21  ENDIF 

1532 

1 1  END; 

L 


Figure  C.l  Standard  MAPOL  Sequence  (Concluded) 
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APPENDIX  D 

Solution  Control  Command  Descriptions 


This  appendix  contains  the  descriptions  of  the  ASTROS  Solution 
control  commands .  These  commands  are  used  in  the  Solution  Control  Packet  to 
select  the  particular  disciplines  and  analyses  to  be  performed  by  the  ASTROS 
procedure . 
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Solution  Control  Command  :  ANALYZE 

Description:  The  first  command  in  the  ANALYZE  subpacki 
Hierarchy  Level:  Type  of  boundary  condition 
Format  and  Example (s): 

ANALYZE 


ANALYZE 


Solution  Control  Command  :  BLAST 
Description:  Invokes  the  blast  discipline 
Hierarchy  Level:  Discipline 
Format  and  Example (s): 

BLAST  Type  (BLCOND  -  i,  TSTEP  -  j) 

BLAST  MODAL  (BLCOND  -  20,  TSTEP  -  30) 

OB-tlffD 
Type 

i 

j 

Remarks : 

1.  BLAST  does  not  generate  design  constraints  for  optimization. 


Meaning 

DIRECT  or  MODAL.  Selects  the  solution  approach. 
Default  -  MODAL. 

Set  identification  of  a  BLAST  bulk  data  entry  used  to 
specifiy  nuclear  blast  parameters. 

Set  identification  of  TSTEP  bulk  data  entries  used  to 
specify  time  step  data  for  the  blast  response 
analysis . 
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Solution  Control  Command  :  BOUNDARY 

Description:  Specifies  the  displacement  sets  and  related  data  to  be  used  in  a 
particular  boundary  condition. 

Hierarchy  Level:  Boundary  condition 

Format  and  Example (s): 

BOUNDARY  MPC  -  i ,  SPC  -  j ,  REDUCE  -  k,  SUPPORT  -  1,  METHOD  -  m,  K2PP  -  n, 

M2PP  -  o,  B2PP  -  p,  DYNRED  -  q,  INERTIA  -  r,  TFL  -  s,  ESET  -  t, 
DAMPING  -  u 

BOUNDARY  SPC  -  6 


BOUNDARY  SPC  -  10,  REDUCE  -  20,  SUPPORT  -  30 

BOUNDARY  SPC  -  10,  METHOD  -  5,  DYNRED  -  25,  K2PP  -  STIFF,  M2PP  -  MASS 


Op-tjon 

i 


j 


k 


1 

m 


n 


o 


P 

q 

r 


s 


t 


u 


Meaning 

Set  identification  of  a  multipoint  constraint  set. 
Invokes  MPC  and  MPCADD  bulk  data  entries 
(Integer  >  0) 

Set  identification  of  a  single-point  constraint. 
Invokes  SPC,  SPC1  and  SPCADD  bulk  data  entries 
(Integer  >  0) 

Set  identification  of  a  static  condensation  set. 
Invokes  ASET,  ASETl,  OMIT  and  OMITl  bulk  data  entries 
(Integer  >  0) 

Set  identification  of  the  free  body  support.  Invokes 
the  SUPORT  bulk  data  entry  (Integer  >  0) 

Identifies  the  EIGR  bulk  data  entry  to  be  used 
(Integer  >  0) 

Selects  the  direct  input  stiffness  matrix.  Refers  to 
a  DMI  or  DMIG  bulk  data  entry  (Character) 

Selects  the  direct  input  mass  matrix.  Refers  to  a 
DMI  or  DMIG  bulk  data  entry  (Character) 

Selects  the  direct  input  damping  matrix.  Refers  to  a 
DMI  or  DMIG  bulk  data  entry  (Character) 

Selects  the  dynamic  reduction  parameters  from  the 
DYNRED  bulk  data  entry  (Integer  >  0) 

Selects  the  JSETi  bulk  data  entries  to  be  used  while 
performing  dynamic  reduction  (Integer  >  0) 

Selects  the  transfer  function  set  to  be  added  to  the 
input  matrices.  Refers  to  TF  bulk  data  entries 
(Integer  >  0) 

Set  identification  of  the  extra  degrees  of  freedom 
for  the  boundary  condition.  Invokes  the  EPOINT  bulk 
data  entries. 

Set  identification  of  damping  data.  Invokes  TABDMP 
and  VSDAMP  bulk  data  entries. 
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Remarks:  1.  Note  that  the  REDUCE  and  ESET  set  specifications  are  an 
innovation  relative  to  NASTRAN 


2.  The  bulk  data  entries  will  not  be  used  in  ASTROS  unless 
selected  in  solution  control. 

3.  None  of  the  options  are  required  but  at  least  one  is  needed. 

4.  K2PP,  M2PP,  B2PP,  TFL  and  DAMPING  options  are  supported  for 
dynamic  disciplines  only  (i.e.,  for  the  FLUTTER,  TRANSIENT  and 
FREQUENCY  disciplines). 

5.  M2PP,  B2PP  and  K2PP  names  will  typically  refer  to  DMI  or  DMIG 
entries,  but  may  refer  to  any  existing  data  base  matrix  entity 
of  the  proper  dimension. 


Solution  Control  Command  :  END 

Description:  Indicates  the  end  of  a  subpacket. 

Hierarchy  Level:  End 
Format  and  Example  (s'): 

END 

END 

Remarks:  1.  ANALYZE  and  OPTIMIZE  subpackets  require  their  own  END  command. 
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Solution  Control  Command  :  FLUTTER 

Description:  Invokes  the  flutter  analysis  discipline 
Hierarchy  level:  Discipline 
Format  and  Example (s): 

FLUTTER  (FLCOND  -  1,  DCONS  -  J) 

FLUTTER 

ORtian 

1  Set  identification  of  a  FLUTTER  bulk  data  entry  that 

provides  flutter  parameters. 

j  Set  identification  of  DCONFLT  bulk  data  entries  which 

define  flutter  constraint  conditions. 

Remarks:  1.  The  FLCOND  parameter  is  required,  DCONS  is  optional. 


* 
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Solution  Control  Command  :  FREQUENCY 

Description:  Invokes  the  frequency  analysis  discipline 

Hierarchy  level:  Discipline 
Format  and  Example (s): 

FREQUENCY  Type  (DLOAD  -  i,  FSTEP  -  j,  GUST  -  k) 
FREQUENCY  MODAL  (DLOAD  -  10,  FSTEP  -  20) 

FREQUENCY  DIRECT  (DLOAD-lOO,  FSTEP-30,  GUST-55) 


Option 

Type 

i 

j 


k 


Remarks :  1 . 

2. 

3. 


Meaning 

DIRECT  or  MODAL.  Selects  the  solution  approach. 

Set  identification  of  a  DLOAD  bulk  data  entry. 

Set  identification  of  frequency  bulk  data  entries 
(i.e. ,  FREQ,  FREQ1,  FREQ2)  that  define  the  frequency 
steps  of  the  analysis. 

Set  identification  of  a  GUST  bulk  data  entry  which 
defines  the  gust  parameters. 

The  FREQUENCY  discipline  does  not  generate  design  constraints 
for  optimization. 

Type,  DLOAD  and  FSTEP  are  required. 

No  more  than  one  FREQUENCY  analysis  can  be  done  in  a  single 
boundary  condition. 


Solution  Control  Command  :  LABEL 

Description:  Provides  identifying  information  on  subcase  output. 

Hierarchy  Level:  Label  information 
Format  and  Example^: 

LABEL  -  n 

LABEL  -  SYMMETRIC  MANEUVER  LOAD 

Q&£ifin  Meaning 

n  Any  descriptive  message  that  the  user  wishes  to  use 

to  distinquish  output. 

Remarks:  1.  LABEL  information  is  used  until  it  is  superseded. 

2.  The  LABEL  command  is  optional. 

3.  Labels  are  limited  to  no  more  than  72  characters. 


240 


Solution  Control  Command  :  MODES 

Description:  Selects  the  Normal  Modes  discipline. 

Hierarchy  Level:  Discipline 
Format  and  Example (s): 

MODES  (DCONS  -  n) 

MODES 

MODES  (DCONS  -  10) 

Qptjgp  Meaning 

n  Set  identification  of  DCONFRQ  bulk  data  entries  which 

define  frequency  constraints  for  the  optimization 
task. 

Remarks:  1.  Only  one  modal  analysis  can  be  performed  in  a  boundary 

condition  using  the  E1GR  data  entry  selected  on  the  BOUNDARY 
command. 
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2.  Any  non-zero  value  of  the  first  digit,  "y" ,  selects  fully 
stressed  design.  The  remaining  3  digits  are  not  used  at 
present,  but  are  intended  for  use  in  directing  other 
optimization  methods . 
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Solution  Control  Command  :  PRINT 


Description:  Specifies  the  required  output  file  processing  for  the  print  file 

Hierarchy  Level:  Various 
Format  and  Example (s): 

PRINT  (Form)  PRES (Form)  -  a,  VELO(Form)  -  b,  DISP(Form)  -  c,  ENER(Form)  -  d, 

FORC(Form)  -  e,  GPFO(Form)  -  f,  LOAD (Form)  -  g,  SPCF(Form)  -  h, 

STRE(Form)  -  i,  ACCE(Form)  -  j,  STRA(Form)  -  k,  ROOT  -  1, 

FREQ  -  m,  MODE  -  n,  TIME  -  o,  DESIGN,  DCONS,  TRIM 

PRINT  DISP  -  ALL 

PRINT  (RECT)  DISP  -  6,  ENERGY(POLA)  -  10 
PRINT  MODES-NONE 


Options 

Form 

a 


b 


c 


d 


e 


f 


g 


h 


i 


j 


Meaning 

RECT  or  POLAr  requests  output  in  RECTangular  or  POlAr 
format  (See  Remark  1). 

Set  identification  of  an  ELEMLIST  bulk  data  entry 
that  is  used  to  request  the  aerodynamic  panels  at 
which  pressures  are  to  be  printed. 

Set  identification  of  a  GRIDLIST  bulk  data  entry  that 
is  used  to  request  the  grid  points  at  which 
velocities  are  to  be  printed. 

Set  identification  of  a  GRIDLIST  bulk  data  entry  that 
is  used  to  request  the  grid  points  at  which 
displacements  are  to  be  printed. 

Set  identification  of  an  ELEMLIST  bulk  data  entry 
that  is  used  to  request  the  elements  for  which  strain 
energies  are  to  be  printed. 

Set  identification  of  a  ELEMLIST  bulk  data  entry  that 
is  used  to  request  the  element  for  which  forces  are 
to  be  printed. 

Set  identification  of  a  GRIDLIST  bulk  data  entry  that 
is  used  to  request  the  grid  points  at  which  grid 
point  forces  are  to  be  printed. 

Set  identification  of  a  GRIDLIST  bulk  data  entry  that 
is  used  to  request  the  grid  points  at  which  applied 
loads  are  to  be  printed. 

Set  identification  of  a  GRIDLIST  bulk  data  entry  that 
is  used  to  request  the  grid  points  at  which  SPC 
forces  are  to  be  printed. 

Set  identification  of  an  ELEMLIST  bulk  data  entry 
that  is  used  to  request  the  elements  for  which 
stresses  are  to  be  printed. 

Set  identification  of  a  GRIDLIST  bulk  data  entry  that 
is  used  to  request  the  grid  points  at  which 
accelerations  are  to  be  printed. 


k 

1 


n 


o 


REMARKS:  1. 


2. 


3. 


Set  identification  of  an  ELEMLIST  bulk  data  entry 
that  is  used  to  request  the  elements  at  which  strains 
are  to  be  printed. 

Set  identification  of  a  MODELIST  bulk  data  entry  that 
is  used  to  request  the  modes  for  which  flutter  root 
results  are  to  be  printed. 

Set  identification  of  a  FREQLIST  bulk  data  entry  that 
is  used  to  request  frequency  output. 

Set  identification  of  a  MODELIST  bulk  data  entry  that 
is  used  to  request  the  modes  for  which  eigenvectors 
are  to  be  printed. 

Set  identification  of  a  TIMELIST  bulk  data  entry  that 
is  used  to  specify  times  of  a  transient  response  at 
which  data  is  to  be  printed. 

Form  is  an  optional  parameter  for  printing  complex  data. 
RECTangular  data  outputs  complex  data  with  real  and  imaginary 
components  while  POLAr  outputs  complex  data  using  magnitude  and 
phase.  If  used  with  the  PRINT  command,  all  complex  data  that 
are  not  otherwise  specified  use  the  requested  Form.  If  used 
with  another  option,  the  Form  overrides  the  global  request. 

Options  a  through  o  can  be  either  ALL,  NONE  or  a  positive 
integer.  ALL  requests  all  values.  NONE  turns  off  a  request 
from  a  previous  hierarchy  while  an  Integer  value  refers  to  a 
bulk  data  entry. 

DESIGN,  DCONS  and  TRIM  are  toggles.  If  they  are  present,  the 
specified  data  are  printed.  DESIGN  indicates  that  information 
on  the  global  and  local  design  variables  are  to  to  be  printed 
at  each  Iteration.  DCONS  indicates  that  constraint  information 
is  to  be  printed  at  each  iteration.  TRIM  indicates  that 
stability  derivative  data  associated  with  an  aeroelastic  trim 
are  to  be  printed. 
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Solution  Control  Command  :  PUNCH 


Description:  Specifies  the  required  output  file  processing  for  the  punch  file 
Hierarchy  Level:  Various 
Format  and  Example (s): 

PUNCH  (Form)  PRES (Form)  -  a,  VELO(Form)  -  b,  DISP(Form)  -  c,  ENER(Form)  -  d, 

FORC(Form)  -  e,  GPFO(Form)  -  f,  LOAD (Form)  -  g,  SPCF(Form)  -  h, 

STRE(Form)  -  i,  ACCE(Form)  -  j,  STRA(Form)  -  k,  ROOT  -  1, 

FREQ  -  m,  MODE  -  n,  TIME  -  o,  DESIGN,  DCONS,  TRIM 

PUNCH  DISP  -  ALL 

PUNCH  (RECT)  DISP  -  6,  ENERGY (POLA)  -  10 
PUNCH  MODES-NONE 


Options 

Form 


a 


b 


c 


d 


e 


f 


g 

h 


i 


j 


Meaning 

RECT  or  POLAr  requests  output  in  RECT angular  or  POLAr 
format  (See  Remark  1). 

Set  identification  of  an  ELEMLIST  bulk  data  entry 
that  is  used  to  request  the  aerodynamic  panels  at 
which  pressures  are  to  be  punched. 

Set  identification  of  a  GRIDLIST  bulk  data  entry  that 
is  used  to  request  the  grid  points  at  which 
velocities  are  to  be  punched. 

Set  identification  of  a  GRIDLIST  bulk  data  entry  that 
is  used  to  request  the  grid  points  at  which 
displacements  are  to  be  punched. 

Set  identification  of  an  ELEMLIST  bulk  data  entry 
that  is  used  to  request  the  elements  for  which  strain 
energies  are  to  be  punched. 

Set  identification  of  a  ELEMLIST  bulk  data  entry  that 
is  used  to  request  the  element  for  which  forces  are 
to  be  punched. 

Set  identification  of  a  GRIDLIST  bulk  data  entry  that 
is  used  to  request  the  grid  points  at  which  grid 
point  forces  are  to  be  punched. 

Set  identification  of  a  GRIDLIST  bulk  data  entry  that 
is  used  to  request  the  grid  points  at  which  applied 
loads  are  to  be  punched. 

Set  identification  of  a  GRIDLIST  bulk  data  entry  that 
is  used  to  request  the  grid  points  at  which  SPC 
forces  are  to  be  punched. 

Set  identification  of  an  ELEMLIST  bulk  data  entry 
that  is  used  to  request  the  elements  for  which 
stresses  are  to  be  punched. 

Set  identification  of  a  GRIDLIST  bulk  data  entry  that 
is  used  to  request  the  grid  points  at  which 
accelerations  are  to  be  punched. 
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1 


n 
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REMARKS:  1. 


2. 


3. 


Set  Identification  of  an  ELEMLIST  bulk  data  entry 
that  is  used  to  request  the  elements  at  which  strains 
are  to  be  punched. 

Set  identification  of  a  MODELIST  bulk  data  entry  that 
is  used  to  request  the  modes  for  which  flutter  root 
results  are  to  be  punched. 

Set  identification  of  a  FREQLIST  bulk  data  entry  that 
is  used  to  request  frequency  output. 

Set  identification  of  a  MODELIST  bulk  data  entry  that 
is  used  to  request  the  modes  for  which  eigenvectors 
are  to  be  punched. 

Set  identification  of  a  TIMELIST  bulk  data  entry  that 
is  used  to  specify  times  of  a  transient  response  at 
which  data  is  to  be  punched. 

Form  is  an  optional  parameter  for  punching  complex  data. 
RECTangular  data  outputs  complex  data  with  real  and  imaginary 
components  while  POLAr  outputs  complex  data  using  magnitude  and 
phase.  If  used  with  the  PUNCH  command,  all  complex  data  that 
are  not  otherwise  specified  use  the  requested  Form.  If  used 
with  another  option,  the  Form  overrides  the  global  request. 

Options  a  through  o  can  be  either  ALL,  NONE  or  a  positive 
integer.  ALL  requests  all  values.  NONE  turns  off  a  request 
from  a  previous  hierarchy  while  an  integer  value  refers  to  a 
bulk  data  entry. 

DESIGN,  DCONS  and  TRIM  are  toggles.  If  they  are  present,  the 
specified  data  are  punched.  DESIGN  indicates  that  information 
on  the  global  and  local  design  variables  are  to  to  be  punched 
at  each  iteration.  DCONS  indicates  that  constraint  information 
Is  to  be  punched  at  each  iteration.  TRIM  indicates  that 
stability  derivative  data  associated  with  an  aeroelastic  trim 
are  to  be  punched. 
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Solution  Control  Command  :  SAERO 

Description:  Invokes  the  static  aeroelastic  discipline. 

Hierarchy  Level:  Discipline 

Format  and  Example  (sV. 

SAERO  (TRIM  -  m,  DCONS  -  n) 

SAERO  (TRIM  -  60) 

SAERO  (TRIM  -  70,  DCONS  -  10) 

Option  Meaning 

m  Set  identification  of  a  TRIM  bulk  data  entry  which 

provides  flight  configuration  information. 

n  Set  identification  of  DCONDSP,  DCONALE  and  DCONCLA 

bulk  data  entries  which  define  constraints  in  an 
optimization  task  for  a  given  trim  condition. 

Remarks:  1.  TRIM  is  required,  DCONS  is  optional. 

2.  If  SAERO  disciplines  are  selected  in  the  Solution  Control,  only 
other  SAERO  disciplines  can  appear  in  the  same  boundary 
condition. 
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Solution  Control  Command  :  SOLUTION 

Description:  The  first  command  in  the  solution  control  packet. 

Hierarchy  Level:  Beginning  of  solution 
Format  and  Example (s): 

SOLUTION 

SOLUTION 

Remarks:  1.  One  and  only  one  SOLUTION  command  must  always  appear  as  the 
first  command  of  the  solution  control  packet. 
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Solution  Control  Command  :  STATICS 

Description:  Invokes  the  statics  analysis  discipline 

Hierarchy  level:  Discipline 

Format  and  Example (s): 

STATICS  (MECH  -  i,  THERMAL  -  j,  GRAVITY  -  k,  DCONS  -  1) 

STATICS  (MECH  -  10) 

STATICS  (MECH  -  4,  THERMAL  -  6,  DCONS  -  12) 

Option  Meaning 

i  Set  identification  for  external  loads  as  defined  by 

LOAD,  PLOAD,  FORCE,  F0RCE1,  MOMENT,  and  MOMENT 1  bulk 
data  entries. 

j  Set  identification  for  temperatures  as  defined  by 

TEMP  or  TEMPD  bulk  data  entries. 

k  Set  identif icaton  of  GRAV  bulk  data  entries  which 

define  gravity  forces. 

1  Set  identification  of  DCONDSP  bulk  data  entries  which 

define  displacement  constraints  in  an  optimization 
task  with  a  statically  applied  load. 

Remarks.  1.  The  sum  of  all  the  loads  forms  a  single  right  hand  side  for  a 
statics  analysis. 

2.  At  least  one  of  the  load  types  must  be  present.  The  DCONS 
parameter  is  optional . 

3.  Gravity  forces  may  be  included  indirectly  if  referenced  by  the 
LOAD  bulk  data  entry. 
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Solution  Control  Command  :  SUBTITLE 

Description:  Defines  a  subtitle  which  will  appear  in  the  output. 
Hierarchy  Level:  Label  information 


SUBTITLE  -  n 

SUBTITLE  -  SUPERSONIC  DESIGN  CONDITION 


Option 


Remarks :  1 . 


Moaning 

Any  descriptive  information  can  be  inserted  here 
SUBTITLE  information  is  used  until  it  is  superseded. 

The  SUBTITLE  command  is  optional . 

Subtitles  are  limited  to  72  characters. 
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Solution  Control  Command  :  TITLE 


Description:  Defines  a  title  which  will  appear  in  the  output. 
Hierarchy  Level  Label  information 
Format  and  Example(s’) : 

TITLE  -  n 


TITLE  -  DESIGN  OF  A  FORWARD  SWEPT  WING  MODEL 


Option 

Meaning 

n 

Any  descriptive  information 

Remarks : 

1. 

TITLE  information  is  used  until  it 

is 

2. 

The  TITLE  command  is  optional. 

3. 

Titles  are  limited  to  no  more  that 

72 

can  be  inserted  here 
superseded. 

characters . 
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Solution  Control  Command  :  TRANSIENT 
Description:  Invokes  the  transient  response  analysis 

Hierarchy  Level:  Discipline 
Fornat  and  F.vpWgV 

TRANSIENT  Type  (DLOAD  -  i,  TSTEP  -  j ,  FFT  -  k,  IC  -  1,  GUST  -  m) 
TRANSIENT  MODAL  (DLOAD  -  10,  TSTEP  -  20) 

TRANSIENT  DIRECT  (DL0AI>-100,  TSTEP-30,  IC  -  45) 

TRANSIENT  MODAL  (DLOAD-35,  TSTEP-2,  FFT-999,  GUST-45) 


Option 

Type 

i 

J 

k 

1 

m 

Renarks :  1 . 


2. 


3. 

4. 


Meaning 

DIRECT  or  MODAL.  Selects  the  solution  approach. 

Set  identification  of  a  DLOAD  bulk  data  entry. 

Set  identification  of  TSTEP  bulk  data  entries  which 
provide  time  step  information  for  the  analysis. 

Set  identification  of  a  FFT  bulk  data  entry  which 
provides  parameters  to  use  Fast  Fourier  Transform 
methods  in  performing  the  transient  analysis 

Set  identification  of  IC  bulk  data  entries  which 
define  initial  conditions. 

Set  identification  of  a  GUST  bulk  data  entry  which 
defines  the  gust  parameters. 

The  TRANSIENT  discipline  does  not  generate  design  constraints 
for  optimization. 

Type,  DLOAD  and  TSTEP  are  required. 

If  GUST  is  present,  FFT  must  also  be  used. 

IC  cannot  be  used  with  the  MODAL  solution  method.  IC  also 
cannot  be  used  with  FFT  or  GUST. 


5. 


No  more  than  one  TRANSIENT  response  analysis  can  be  performed 
in  a  single  boundary  condition. 


APPENDIX  E 


BULK  DATA  ENTRIES 

This  appendix  contains  the  complete  documentation  for  all  bulk  data 
packet  inputs  to  the  ASTROS  system.  Each  field  of  each  bulk  data  entry  is 
described  in  detail  regarding  its  use  in  the  ASTROS  system,  the  data  type 
requirements,  and  any  defaults  that  are  defined.  In  addition,  the  bulk  data 
descriptions  include  documentation  regarding  interactions  both  among  bulk  data 
entries  and  among  the  data  fields  of  each  data  entry.  These  data  are  listed 
in  alphabetical  order  by  bulk  data  entry  name. 


Input  Data  Entry  ^Comment 

Description:  For  user  convenience  in  inserting  commentary  material  into  the 

unsorted  echo  of  the  input  Bulk  Data  Deck.  The  $  entry  is 
otherwise  ignored  by  the  program.  These  entries  will  not 
appear  in  a  sorted  echo. 

Format  and  Example: 


1234  ->  6789  _ 10 


$ 

Followed  bv  anv  leeimate  characters  in  columns  2-80 

THIS  IS  A  REMARK  i  j 

Input  Data  Entry  AEFACT  Aerodynamic  Lists 

Dcacrintion:  Used  to  specify  lists  of  real  numbers  for  aeroelastic  analysis. 

Format  and  Example: 


123456789  10 


AEFACT 

im» 

Dl 

D2 

!  D3 

D4 

D5 

D6 

D7 

AEFACT _ 

.3 

.7 

mwm 

CONT  j 

CCNT 

D8 

1  D9  1 

1  -ETC-  1 

1  1 

M  ■ 

■ 

I  ■ 

■■■ 

■  ■ 

■ 

■ 

■ 

■  ■ 

■ 

1 

Field  Contents 

SID  Set  identification  number  (Unique  Integer  >  0) . 

Di  Number  (Real). 

Remarks : 

1.  These  factors  are  selected  by  AIRFOIL,  AXSTA,  CAEROi  and/or 
PAEROi  data  entries. 

2.  Imbedded  blank  fields  are  forbidden. 

3.  If  used  to  specify  division  points,  note  that  there  is  one 
more  division  point  than  the  number  of  divisions. 
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Input  Data  Entry  AERO 


Aerodynamic  Physical  Data 


Description:  Gives  basic  aerodynamic  parameters  for  unsteady  aerodynamic 

disciplines . 

Format  and  Examples : 


_ 1 _ 

2 

3 

4 

5 

6 

7 

8 

9 

mum 

mmm 

Iacsid  1 

REFC 

1  RHOREF  1 

B  B 

B  B 

B 

mm 

Bi 

RH 

300.0 

mrm 

■■■ 

MBBB 

Eleld 

ACSID 

REFC 

RHOREF 


Contents 

Aerodynamic  coordinate  system  identification  (Integer  >  0) . 
See  Remark  2 . 

Reference  length  (for  reduced  frequency)  (Real). 

Reference  density  (Real). 


Remarks : 

1.  This  entry  is  required  for  unsteady  aerodynamic  disciplines. 
Only  one  AERO  entry  is  allowed. 

2.  The  ACSID  must  be  a  rectangular  coordinate  system.  Flow  is 
in  the  positive  x-direction. 
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Input  Data  Entry  AEROS  Static  Aero  Physical  Data 
Description:  Gives  basic  parameters  for  static  aeroelasticity . 

Format  and  Examples: 


I _ .2  .3  4  5  6  7  8  9  L  IQ 


AEROS 

ACSID 

RCSID 

REFC 

REFB 

REFS 

GREF 

REFD 

REFL 

&EEQ2 _ 

-10 

20 

-10. . 

-1QQ, . 

1QQQ. 

_1 _ 

Field 

ACSID 

RCSID 

REFC 
REFB 
REFS 
GREF 
REFD 
REFL 
Remarks : 


Qantms 

Aerodynamic  coordinate  system  identification  (Integer  >  0) . 
See  Remark  2. 

Reference  coordinate  system  identification  for  rigid  body 
motions  (Integer  >.0). 

Reference  chord  length  (Real  >  0.0) (D  -  1.0) 

Reference  span  (Real  >  0.0) (D  -  1.0) 

Reference  wing  area  (Real  >  0.0) (D  -  1.0) 

Reference  grid  point  for  stability  derivative  calculations. 
Fuselage  reference  diameter  (Real  >  0)(D  -  1.0) 

Fuselage  reference  length  (Real  >  0)(D  -  1.0) 


1.  This  entry  is  required  for  static  aeroelasticity  problems. 
Only  one  AEROS  entry  is  allowed. 

2.  The  ACSID  must  be  a  rectangular  coordinate  system.  Flow  is 
in  the  positive  x- direct ion. 

3.  The  RCSID  must  be  a  rectangular  coordinate  system.  All 
degrees  of  freedom  defining  trim  variables  will  be  defined  in 
this  coordinate  system. 
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Input  Data  Entry  AESURF  Aerodynamic  Control  Surface 
Description:  Specifies  an  aerodynamic  control  surface. 

Format  and  Example: 


1 _ , _ 2 _ , _ 2 _ k _ 5 _ , _ * _ , _ Z _ £ _ 2 _ .  1C 


rTTTnTlM 

ifn  m 

^hTiiI 

IJW.MI 

rrsflffil 

■77T7B 

VTmSI 

■  i  ■  \'m 

■MM 

■h 

wmm 

■MM 

■ 

■ 

225 

FT4  J  ;?■ 

■4M 

I75TOJ 

rrvm 

■ 

■ 

■MM 

■7m 

■7m 

■ 

■ 

mm 

Field 

SETID 

LABEL 

ACIDi 

CIDi 

FBOXIDi 
LBOXIDi 
Remarks : 


Contents 

Identification  number  of  an  aerodynamic  trim  variable  degree 
of  freedom  (Integer  >  0). 

An  alphanumeric  string  of  up  to  eight  characters  to  identify 
the  control  surface . 

ID  of  the  aircraft  component  that  the  surface  is  on. 

Identification  number  of  a  rectangular  coordinate  system 
whose  y-axis  defines  the  hinge  line  of  the  control  surface. 

First  aero  box  on  the  control  surface  relative  to  ACIDi. 

Last  aero  box  on  control  surface,  relative  to  ACIDi. 


1.  Either  one  or  two  control  surfaces  may  be  defined,  depending 
on  the  symmetry  flag. 

2.  Allowable  values  of  LABEL  are:  ELEV,  AILERON  and  RUDDER. 
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Input  Data  Entry  AIRFOIL 

Description:  Defines  airfoil  properties  for  USSAERO. 

Format  and  Examples: 


1  .2  3  ,4  5  6  7  8  9  10 


CP 

IUST  1 

ILST 

ICAM 

wtxm 

__1 _ 

-W1N0- 

_J. _ 

BTH 

__30 

ate _ 1 

COST 

XI 

Yl 

Z1 

XI 2 

1 

±K _ 

0.0 

o.o 

$Q. 

Field 


Content? 


ACID 


Associated  aircraft  component  ID  (Integer  >  0) . 


CMPNT 


Type  of  aircraft  component  (Text). 


CP 


ICHORD 


IUST, 

ILST 


I  CAM 


RADIUS 


Coordinate  system  for  airfoil  (Integer). 

ID  of  an  AEFACT  data  entry  containing  a  list  of  division 
points  (in  terms  of  percent  chord)  at  which  airfoil  data  are 
specified  (Integer). 

ID  of  an  AEFACT  data  entry  containing  a  list  of  airfoil  half 
thicknesses  in  percent  chord  at  the  chordwise  cuts  for  the 
upper  and  lower  surfaces,  respectively  (Integer). 

ID  of  an  AEFACT  data  entry  containing  a  list  of  airfoil 
camber  values  (z-ordinates  expressed  in  percent  chord)  at  the 
chordwise  cuts  (Integer). 

Radius  of  the  leading  edge,  expressed  in  percent  chord 
(Real) . 


XI,  Yl,  Z1 


Location  of  airfoil  leading  edge  in  coordinate  system  CP 
(Real) . 


X12 

I PANEL 

Remark: 


Airfoil  chord  length  in  coordinate  system  CP.  (Real  >  0). 

ID  of  an  AEFACT  data  entry  containing  a  list  of  chordwise 
cuts  for  wing  panelling. 


1.  Allowable  components  are  WING,  FIN  and  CANARD. 

2.  ILST  and  ICAM  present  redundant  information  so  that,  at  most, 
only  one  can  be  non- zero. 

3.  ICAM  cannot  be  defined  for  FIN  and  CANARD  components.  ILST 
cannot  be  defined  for  FIN  components. 
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4.  If  the  RADIUS  field  is  blank,  a  round  leading  edge  of  radius 
zero  is  used. 

5.  IPANEL  is  optional  and  is  used  when  different  chordwise  cuts 
on  each  end  of  the  panel  are  desired. 
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I 

Input  Data  Entry  ASET  Selected  Coordinates  for  the  a-^et 

Description.  Defines  degrees  of  freedom  that  the  user  desires  to  place  in  j 

the  analysis  set.  Used  to  define  the  number  of  independent  | 

degrees  of  freedom. 

Format  and  Examples: 


Kb 

Kb 

Kl 

mum 

iWjEgM _ 

mrm 

K7S 

b8 

HwmL _ 

WKTM i 

■■ 

WKM 

KSTl 

IHi 

BBI 

■BBI 

■Hi 

Field 

SETID 

ID 

C 


Contents 

The  set  identification  number  of  the  REDUCE  set. 

Grid  or  scalar  point  identification  number  (Integer  >  0) 

Component  number,  zero  or  blank  for  scalar  points,  any  unique 
combinations  of  the  digits  1-6  for  grid  points. 


Remarks : 

1.  Coordinates  specified  on  this  entry  form  members  of  a  mutual¬ 
ly  exclusive  set.  They  may  not  be  specified  on  other  entries 
that  define  mutually  exclusive  sets. 

2.  When  only  ASET  and/or  ASET1  entries  are  present,  all  degrees 
of  freedom  not  otherwise  constrained  will  be  placed  in  the  o- 
set. 

3.  ASET  entries  must  be  selected  in  Solution  Control  (RE- 
DUCE— SETID)  to  be  used 
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Input  Data  Entry  ASET1  Selected  Coordinates  for  the  a- set,  Alternate 

Form 

Description:  Defines  degrees  of  freedom  that  the  user  desires  to  place  in 

the  analysis  set.  Used  to  define  the  number  of  independent 
degrees  of  freedom. 

Format  and  Examples: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

__  10 

ASET1  _ . 

C 

G  i 

G 

G 

G 

G 

G 

CONT 

ASET1 _ 

345 

2 

1  1 

3 

10 

9 

6 

13 

ABC 

1  1 

1  ■ 

I  ■ 

■  ■ 

— f 

mam m 

mi 

■  ■ 

■■■ 

SB, 

Alternate  Form: 


Elg.ld 

SETID 

C 


G.ID1.ID2 

Remarks : 


1. 


Contents 

The  REDUCE  set  identification  number 

Component  number  (any  unique  combination  of  the  digits  1-6 
with  no  imbedded  blanks)  when  point  identification  numbers 
are  grid  points;  must  be  null  or  zero  if  point  identification 
numbers  are  scalar  points. 

Grid  or  scalar  point  identification  numbers  (Integer  >  0, 
ID2  >  ID1) 


Coordinates  specified  on  this  entry  form  members  of  a  set 
that  is  exclusive  from  other  sets  defined  by  bulk  data 
entries . 


2.  When  only  ASET  and/or  ASET1  entries  are  present,  all  degrees 
of  freedom  not  otherwise  constrained  will  be  placed  in  the  o- 
set . 

3.  If  the  alternate  form  is  used,  all  points  in  the  sequence  IDl 
through  ID2  are  required  to  exist. 

4.  ASET1  entries  must  be  selected  in  Solution  Control  (RE- 
DUCE-SETID)  to  be  used. 


« 


, 

€ 


< 


I 


« 


I 


t 
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Input  Data  Entry  ATTACH 


Description:  Defines  the  aerodynamic  control  points  to  be  attached  to  £. 

reference  grid  for  load  transfer. 

Format  and  Examples: 


Field 

Contents 

EID 

Element  identification  number  (Integer  >  0) 

MACROID 

Element  id  of  a  CAERO;  or  PAERO;  element  which  contains  the 
specified  aerodynamic  control  points  (Integer  >  0) 

B0X1 ,  BOX2 

Starting  and  final  box  whose  force  is  to  be  transferred  to 
the  referenced  grid  (Integer  >  0,  B0X2  >  B0X1) 

RGRID 

Grid  point  id  of  reference  grid  point  (Integer  >  0) 

Remarks : 

1. 

The  EID  is  used  only  for  error  messages. 

2. 

This  entry  applies  to  both  the  steady  and  unsteady  aerodynam¬ 
ic  models . 

3. 

The  attached  aerodynamic  boxes  are  selected  as  shown  below: 

Input  Data  Entry  AXSTA 

Description:  Defines  body  axial  station  parameters. 
Format  and  Examples : 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

AXSTA 

BCID 

XSTA 

CBOD 

ABOD 

LYRAD 

LZRAD 

1 

&LSIA _ 

_ IQ _ 

10.00 

0.5 

_  20— 

1 

Field 

Contents 

BCID 

Body  component  ID  (Integer  >  0) 

XSTA 

Value  of  the  x-ordinate  of  the  body  station  (Real) 

CBOD 

Value  of  the  z-ordinate  of  the  center  line  at  this  station. 
This  defines  the  body  camber  (Real) . 

ABOD 

Cross  sectional  area  of  the  body  at  this  station  (Real) . 

LYRAD; 

LZRAD 

ID  of  an  AEFACT  data  entry  containing  a  list  of  the 
y-ordinates  (z-ordinates)  of  the  body  section.  (Integer) 

Remarks : 

1. 

If  ABOD  is  present,  the  body  is  assumed  to  be  circular  and 
the  radial  ordinates  are  computed  at  NRAD  (cf.  the  BODY  bulk 
data  entry)  equal  intervals.  No  LYRAD  and  LZRAD  data  are 
allowed  when  ABOD  is  present. 

2. 

If  ABOD  is  blank,  LYRAD  and  LZRAD  data  must  be  present. 

3. 

For  Pods,  CBOD,  LYRAD  and  LZRAD  data  are  not  permitted. 

4. 

For  the  fuselage,  XSTA  is  actual  x  location;  for  pods,  XSTA 
is  relative  to  the  XLOC  value  given  on  the  BODY  bulk  data 
entry . 
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Input  Data  Entry  BAROR  Simple  Beam  (BAR)  Orientiation  Default  Values 
Description:  Defines  default  values  for  fields  3  and  6  -  8  of  the  CBAR  entry. 
Format  and  Example: 


123456789  10 


BAROR 

PID 

XI  .GO 

X2 

X3 

]^hST 

SABQ& _ 

—3  9 

im 

2.9 - 

-5,8i_ 

Eislfl 

PID 

X1,X2,X3 


GO 

Remarks 


Cans, sn.t, s 

Identification  number  of  PBAR  property  entry  (Integer  >  0  or 
blank) 

Vector  components  measured  in  displacement  coordinate  system 
at  GA  to  determine  (with  the  vector  from  end  A  to  end  B)  the 
orientation  of  the  element  coordinate  system  for  the  bar 
element  (Real  or  blank) . 

Grid  point  identification  number  (Integer  >  0). 


1.  The  contents  of  fields  on  this  entry  will  be  assumed  for  any 
CBAR  entry  whose  corresponding  fields  are  blank. 

2.  Only  one  BAROR  entry  may  appear  in  the  user's  Bulk  Data 
Packet. 
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Input  Data  Entry  BLAST 


Nuclear  Blast  Parameters 


Description:  Defines  basic  parameters  needed  for  nuclear  blast  response 

analysis. 


Format  and  Examples: 


1  _ 

2 

3 

4 

5 

6 

_ 7 _ 

8 

9 

HI 

BLAST 

1  BLID  1 

10 

kttaw.vd 

BLAST 

na 

IHH 

BIEEI 

mu 

1  0.8 _ 1 

1  1 

i  1 

1  ABC 

CONT 

KGRD 

NZ 

+BC 

1  1 

1 _ 2 _ 1 

1 _ 10  J 

Ed 

i 

CONT_ 1 

1  TMIN  1 

1  TMAX  1 

1  NTIME  I 

1  bminJ 

1  bmax  1 

Inbeta  1 

1  1 

1  1 

■  ■ 

■■■■ 

■ 

■  ■ 

■  ■ 

■  ■ 

■ 

i 

i 

Field  Contents 


BLID 

ALTITUDE 

VELOCITY 

WKT 

BALT 

MACH 

DELTAX 

DELTAY 

KGRD 

HGRD 

SYMXZ 

SYMXY 

TRSURF 

NZ 


Set  identification  number  referenced  by  Solution  Control. 
(Integer  >  0  ) 

Aircraft  altitude  (  Real  ) 

Aircraft  velocity  (Real  >0.0  ) 

Weapon  yield  (  Real  ) 

Blast  altitude  (  Real  ) 

Mach  number  (  Real  0.0  <  Mach  <  1.0  ) 

X  distance  from  aircraft  to  blast  point  (  Real  ) 

Y  distance  from  aircraft  to  blast  point  (  Real  ) 

Key  denoting  presence  of  the  ground 

-  0 ,  no  ground 

-  1  include  the  ground 

Height  of  ground  level  (  Real  ) 

Symmetry  flag  for  blast  analysis  about  xz  plane 
Symmetry  flag  for  blast  analysis  about  xy  plane 
ID  of  an  AESURF  entry  used  as  the  trim  surface 
Load  factor  for  the  trim  calculation 


TMIN 


Minimum  time  used  in  the  definition  of  polynomial  curve 
fitting  (  Real  >  0.0,  def  -  0.10  ) 
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TMAX 


Maximum  time  used  In  the  definition  of  polynomial  curve 
fitting  (  Real  >  0.0,  def  -  20.0  ) 

NTIME  Number  of  time  steps  (  Integer  >  0,  def  -  20  ) 

BMIN  Minimum  Beta  value  used  in  the  definition  of  polynomial  curve 

fitting  (  Real  >  0.0,  def  -  0.375  ) 

BMAX  Maximum  Beta  value  used  in  the  definition  of  polynomial  curve 

fitting  (  Real  >  0.0,  def  -  10.0  ) 

NBETA  Number  of  Beta  values  (  Integer  >  0,  def  -  7  ) 


Remarks : 


1.  In  order  to  be  used,  the  BLID  must  be  referenced  by  Solution 
Control . 


2.  The  second  continuation  entry  Is  not  required. 

3.  The  default  values  of  TMIN,  TMAX,  NTIME,  BMIN,  BMAX  and  NBETA 
should  be  adequate . 

4.  The  symmetry  flags  refer  to  the  options  selected  on  the 
MKAER01  entries. 
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ign 

■ST9I 

KuTfiM 

VWA 

■7771 

w*ryjM 

■ 

— 

Btl 

1  alii  3  41 

m 

■  ■ 

■■ 

mm 

Field 

Copteptg 

BCID 

Body  component  ID  (Integer  >  0) 

CMPNT 

Component  type  (FUSEL  for  the  fuselage  or  POD  for  a  pod) 

CP 

Coordinate  system  for  the  input  geometry. 

NRAD 

Number  of  equal  radial  cuts  used  to  define  the  body. 

XLOC;YLOC; 

ZLOC 

Ordinates  of  the  body  in  the  CP  coordinate  system 

RgwarKs : 

1.  NRAD  is  input  if  equally  spaced  radial  cuts  are  desired. 
Arbitrary  radial  cuts  are  specified  using  the  AXSTA  and 
AEFACT  data  entries. 

2.  The  geometry  given  with  the  XLOC,  YLOC,  ZLOC  entries  is 
only  with  POD  components. 

used 
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Input  Data  Entry  CAER01  Unsteady  Aerodynamic  Panel  Element  Connection 


Description:  Defines  an  aerodynamic  macroelement  (panel)  in  terms  of  two 
leading  edge  locations  and  side  chords.  This  is  used  for 

Doublet-Lattice  theory. 

Format  and  Examples: 


1  2  3  4  5  6  7  8  910 


wrrm 

vm 

H7SI 

IMlVilil 

■77TV 

pTTTTWB 

— 

mwm 

— 

■■■ 

— 

v.mi 

pi  'i*1H _ . _ 

ElBI 

Field 

EID 

PID 

CP 

NSPAN 


NCHORD 

LSPAN 

LCHORD 

IG1D 

X1.Y1.Z1; 

X4,Y4,Z4 

XI 2;  X43 


Contents 

Element  identification  number  (Integer  >  0). 

Identification  number  of  property  entry  (Integer  >  0  or 
blank).  Used  to  specify  associated  bodies. 

Coordinate  system  for  locating  points  1  and  4  (Integer  >  0  or 
blank) . 

Number  of  spanwise  boxes;  if  a  positive  value  is  given,  NSPAN 
equal  divisions  are  assumed;  if  zero  or  blank,  a  list  of 
division  points  is  given  at  LSPAN,  field  7  (Integer  >  0  or 
blank) . 

Number  of  chordwise  boxes;  if  a  positive  value  is  given, 
NCHORD  equal  divisions  are  assumed;  if  zero  or  blank,  a  list 
of  division  points  is  given  at  LCHORD,  field  8  (Integer  >  0 
or  blank) . 

ID  of  an  AEFACT  data  entry  containing  a  list  of  division 
points  for  spanwise  boxes.  Used  only  if  NSPAN,  field  5,  is 
zero  or  blank  (Integer  >  0  or  blank) . 

ID  of  an  AEFACT  data  entry  containing  a  list  of  division 
points  for  chordwise  boxes.  Used  only  if  NCHORD,  field  6,  is 
zero  or  blank  (Integer  >  0  or  blank). 

Interference  group  identification  (aerodynamic  elements  with 
different  IGID's  are  uncoupled)  (Integer  >  0). 

Location  of  points  1  and  4,  in  coordinate  system  CP  (Real). 


Edge  chord  lengths  (in  aerodynamic  coordinate  system) 
(Real  >  0,  and  not  both  zero). 
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The  boxes  are  numbered  sequentially,  beginning  with  EID. 

The  number  of  division  points  is  one  greater  than  the  number 
of  boxes.  Thus,  if  NSPAN  -  3,  the  division  points  are  0.0, 
0.333,  0.667,  1.000.  If  the  user  supplies  division  points, 
the  first  and  last  points  need  not  be  0.  and  1.  (in  which 
case  the  corners  of  the  panel  would  not  be  at  the  reference 
points) . 

A  triangular  element  is  formed  if  X12  or  X43  -  0.0 

The  element  coordinate  system  (right-handed)  is  shown  in  the 
sketch  below. 

The  continuation  entry  is  required. 


Input  Data  Entry  CAER02  Unsteady  Aerodynamic  Body  Connection 
Description:  Defines  an  aerodynamic  body  for  Doublet-Lattice  aerodynamics. 

Format  and  Examples: 


1 _ .2  3  4  5  6  7  8  9  10 


vrm 

■ 

BTTTil 

KTTTa 

mrnm 

■in 

mam 

■rim 

BI9H 

mm 

Eislfl 

EID 

PID 

CP 

NSB 

NINT 

LSB 

LINT 


IGID 

X1.Y1.Z1 

X12 

Remarks : 


Contents 

Element  identification  number  (Integer  >  0). 

Property  identification  number  (Integer  >  0). 

Coordinate  system  for  locating  point  1  (Integer  >  0). 

Number  of  interference  elements;  if  a  positive  number  is 
given,  NSB  equal  divisions  are  assumed;  if  zero  or  blank,  see 
field  7  for  a  list  of  divisions  (Integer  >  0  or  blank). 

Number  of  interference  elements;  if  a  positive  number  is 
given,  NINT  equal  divisions  are  assumed;  if  zero  or  blank, 
see  field  8  for  a  list  of  divisions  (Integer  >  0  or  blank). 

ID  of  an  AEFACT  data  entry  for  slender  body  division  points; 
used  only  if  NSB,  field  5,  is  zero  or  blank  (Integer  >  0  or 
blank) . 

ID  of  an  AEFACT  data  entry  containing  a  list  of  division 
points  for  interference  elements;  used  only  if  NINT,  field  6, 
is  zero  or  blank  (Integer  >  0  or  blank). 

Interference  group  identification  (aerodynamic  elements  with 
different  IGID's  are  uncoupled)  (Integer  >  0). 

Location  of  point  1  in  coordinate  system  CP  (Real). 

Length  of  body  in  the  x-direction  of  the  aerodynamic  coordi¬ 
nate  system  (Real  >  0) . 


1.  Point  1  is  the  leading  point  of  the  body. 

2.  All  CAER01  (panels)  and  CAER02  (bodies)  in  the  same  group 
(IGID)  will  have  aerodynamic  interaction. 

3.  At  least  one  interference  element  is  required  for  each 
aerodynamic  body  specified  by  this  entry. 
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4.  Element  identification  numbers  on  the  aerodynamic  bodies  must 
have  the  following  sequence: 

(A)  Panels  first 

(B)  Z  bodies  (see  PAER02  orientation  flag) 

(C)  ZY  bodies 

(D)  Y  bodies 


Input  Data  Entry  CAER06 


Description:  Defines  an  aerodynamic  macroelement  (panel)  for  steady  aero- 
elasticity. 


Format  and  Examples: 


_ 1 _ 

2 

_ 2 _ 

4 

5 

6 

7 

8 

9 

ACID 

CP 

IGRP 

I?5T5Enj 

| 

1 

_1 _ 

20 

_ J0_ 

Field 


Contents 


ACID 
CMPNT 
CP 
I  GRP 
LCHORD 


LSPAN 


Remarks : 


Component  ID  (Integer  >  0) 

Aircraft  component  (Text) 

Coordinate  system  (Integer) 

Group  number  for  this  component  (Integer) 

ID  of  AEFACT  data  entries  containing  a  list  of  division 
points  in  percent  chord  for  chordwise  boxes  for  aerodynamic 
surface.  If  LCHORD  is  zero,  the  chordwise  divisions  are 
identified  by  the  IPANEL  entry  on  the  AIRFOIL  bulk  data 
entry  (Integer  >  0,  or  blank). 

ID  of  an  AEFACT  data  entry  containing  a  list  of  division 
points  in  terms  of  dimensional  span  stations  for  spanwise 
boxes.  If  this  is  zero  or  blank,  the  y  locations  from  the 
AIRFOIL  bulk  data  entries  for  the  component  ACID  are  used 
(Integer  >  0,  or  blank). 


1.  Allowable  components  are  WING,  FIN  and  CANARD. 

2.  The  IGRP  field  allows  related  components  to  be  processed 
together  for  interference  effects;  e.g.,  one  group  could  be 
a  wing/body/tail  combination  while  a  second  group  would  oe  a 
pod/fin  combination. 

3.  Note  that  chordwise  cuts  are  in  percent  while  spanwise  cuts 
require  physical  coordinates.  For  spanwise  cuts,  y-coordi- 
nates  are  input  for  wings  and  canards  while  z-coordinates  are 
input  for  fins. 
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Input  Data  Entry  CBAR  Simple  Beam  Element  Connection 

Description:  Defines  a  simple  beam  element  (BAR)  of  the  structural  model. 
Format  and  Examples: 


i 


J 


Field 

EID 

PID 

GA.GB 

X1.X2.X3 

GO 

TMAX 

PA,  PB 


W1A.W2A.W3A 


Contents 

Unique  element  identification  number  (Integer  >  0) . 

Identification  number  of  a  PBAR  property  entry  (Default  is 
EID  unless  BAROR  entry  has  nonzero  entry  in  field  3)  (Inte¬ 
ger  >  0) 

Grid  point  identification  numbers  of  connection  points 
(Integer  >  0). 

Components  of  vector  {v},  at  end  A,  measured  at  end  A, 
parallel  to  the  components  of  the  displacement  coordinate 
system  for  GA,  to  determine  (with  the  vector  from  end  A  to 
end  B)  the  orientation  of  the  element  coordinate  system  for 
the  BAR  element  (Real) 

Grid  point  identification  number  to  optionally  supply  XI,  X2, 
X3  (Integer  >  0).  Direction  of  orientation  vector  is  GA  to 
GO 

Maximum  allowable  cross-sectional  area  in  design  (Real  >  0.0 
or  blank) . 

Pin  flags  for  bar  ends  A  and  B,  respectivly  (up  to  5  of  the 
unique  digits  1-6  anywhere  in  the  fields  with  no  imbedded 
blanks;  Integer  >  0).  Used  to  remove  connections  between  the 
grid  point  and  selected  degrees  of  freedom  of  the  bar.  The 
degrees  of  freedom  are  defined  in  the  element's  coordinate 
system.  The  bar  must  have  stiffness  associated  with  the  pin 
flag.  For  example,  if  PA-4  is  specified,  the  PBAR  entry  must 
have  a  value  for  J,  the  torsional  stiffness. 

Components  of  offset  vectors  (wa)  and  (wb) ,  respectively,  in 
displacement  coordinate  systems  at  points  GA  and  GB,  respec¬ 
tively  (Real  or  blank) . 


« 


« 


« 


« 


( 


Remarks :  f 

1.  If  there  are  no  pin  flags  or  offsets,  the  continuation  entry 
may  be  omitted. 
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2.  The  TMAX  value  is  used  only  for  shape  function  design  varia¬ 
ble  linking. 

3.  See  the  BAROR  entry  for  default  options  for  fields  3  and  6-8. 
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Input  Data  Entry  CELAS1  Scalar  Spring  Connection 


Description:  Defines  a  scalar  spring  element  of  the  structural  model. 

Format  and  Example: 


_ 1 _ 

2 

3 

4 

5 

6 

7 

_ 8 _ 

9 

.10 

“1  _ ! 

EID 

PID 

Gl 

Cl 

G2 

C2 

wznm 

1 

2 

6 

_§ _ 

_l _ 

1 

Held 

EID 

PID 

Gl,  G2 
Cl,  C2 
TMAX 
Remarks : 


Contents 

Element  identification  number  (Integer  >  0) 

Identification  number  of  a  PELAS  property  entry  (Default  is 
EID)  (Integer  >  0) 

Geometric  grid  point  identification  number  (Integer  >  0) 
Component  number  (6  >  Integer  >  0) 

Maximum  spring  constant  value  for  design 


1.  Scalar  points  may  be  used  for  Gl  and/or  G2 ,  in  which  case  the 
corresponding  Cl  and/or  C2  must  be  zero  or  blank.  Zero  or 
blank  may  be  used  to  indicate  a  grounded  terminal  Gl  or  G2 
with  a  corresponding  blank  or  zero  Cl  or  C2,  A  grounded 
terminal  is  a  point  whose  displacement  is  constrained  to 
zero . 

2.  The  two  connection  points  (Gl ,  Cl)  and  (G2,  C2)  must  be 

distinct. 

3.  TMAX  is  ignored  unless  the  element  is  designed  using  shape 
function  linking. 
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Input  Data  Entry  CELAS2  Scalar  Spring  Property  and  Connection 


Description:  Defines  a  scalar  spring  element  of  the  structural  model  without 

reference  to  a  property  entry. 

Format  and  Examples: 


1 _ 2  3  4  5  6  7 _  8  9  10 


mwm 

n 

H3S 

H3Hi 

K3Hi 

H3S 

HRS 

HRS 

HHHI 

1^^^11111 

H9HI 

■■■1 

mam 

rFaTHMH 

HTTm 

Field 


Contents 


EID 

K 

Gl,  G2 
Cl,  C2 
GE 
S 


Element  identification  number  (Integer  >  0). 

The  value  of  the  scalar  spring  constant  (Real) . 

Geometric  grid  point  identification  number  (Integer  >  0) . 
Component  number  (6  >  Integer  >  0). 

Damping  coefficient  (Real). 

Stress  coefficient  (Real) . 


TMIN,  TMAX  Minimum  and  maximum  spring  constant  values  for  design. 

Reaetks : 

1.  Scalar  points  may  be  used  for  Gl  and/or  G2  in  which  case  the 
corresponding  Cl  and/or  C2  must  be  zero  or  blank.  Zero  or 
blank  may  be  used  to  indicate  a  grounded  terminal  Gl  or  G2 
with  a  corresponding  blank  or  zero  Cl  or  C2.  A  grounded 
terminal  is  a  point  whose  displacement  is  constrained  to 
zero . 


2.  This  single  entry  completely  defines  the  element  since  no 
material  or  geometric  properties  are  required. 

3.  The  two  connection  points  (Gl,  Cl)  and  (G2,  C2)  must  be 

distinct. 

4.  The  TMIN  and  TMAX  values  are  ignored  unless  shape  function 
design  variable  linking  is  used. 
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Remarks : 

1.  Grid  points  Gl,  G2 ,  G3,  and  G4  must  be  given  in  counter¬ 
clockwise  order  about  one  quadrilateral,  with  Gl  and  G5  along 
the  same  edge . 

2.  There  is  no  non -structural  mass. 

3.  The  quadrilateral  faces  need  not  be  planar. 

4.  Stresses  are  given  in  the  basic  coordinate  system. 

5.  The  continuation  is  required. 

6.  No  physical  property  of  this  element  can  be  used  as  a  local 
design  variable  for  automated  design. 
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Input  Data  Entry  CIHEX2  Quadratic  Isoparametric  Hexahedron  Element 

Connection 

Description:  Defines  a  quadratic  isoparametric  hexahedron  element  of  the 

structural  model. 

Eormat  and  Example: 


_ 1 _ 

2 

3 

4 

5 

6 

7 

8 

9 

10 

111"  .11 

EID 

!  PID 

Gl 

G2 

G3 

G4 

G5 

G6 

CIHEX1 

mum 

7 

3 

8 

12 

13 

14 

9 

ABC 

07 

G8 

G9 

G10 

Gil 

G12 

G13 

G14 

+BC _ 

5 _ 

4 

16 

_ 19 

20 

17  _ 

23 

27 

DEF 

j 

G15 

G16 

G17 

G18 

G19 

G20 

+EF 

_31_ 

.,32... 

33 

28 

-.2,3 

24 

Field 


Contents 


EID  Element  identification  number  (Integer  >  0). 

PID  Identification  number  of  a  PIHEX  property  entry  (Integer  > 

0). 


Gl . G20  Grid  point  identification  numbers  of  connection  points 

(Integer  >0,  Gl  i*  G2  t*  ....  *  G20)  . 


G17  G16  G15 


Remarks : 

1.  Grid  points  Gl . 8  must  be  given  in  counter-clockwise  order 

about  one  quadrilateral  face  when  viewed  from  inside  the 
element.  G9 . G12  and  G13,...,G20  are  in  the  same  direc¬ 

tion  with  Gl,  G9  and  G13  along  the  same  edge. 

2.  There  is  no  non- structural  mass. 

3.  The  quadrilateral  faces  need  not  be  planar. 

4.  Stresses  are  given  in  the  basic  coordinate  system. 
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Both  continuations  are  required. 

No  physical  property  of  this  element  can  be  used  as  a  local 
design  variable  in  automated  design. 


I 


Input  Data  Entry  CIHEX3  Cubic  Isoparametric  Hexahedron 

Element  Connection 

Description:  Defines  a  cubic  isoparametric  hexahedron  element  of  the  struc¬ 

tural  model. 

Format  and  Examples: 


1  2 _ 3  4 _ 5 _ § _ Z _ § _ 9 _ 10 


CIHEX1 

G1 

G2 

G4 

G5 

G6 

CONT 

mi _ 

4 

_ 2 _ 

17 

18 

,  19 _ 

ABC 

Remarks : 


1.  Grid  points  G1 . G12  must  be  given  in  counter-clockwise 

order  about  one  quadrilateral  face  when  viewed  from  inside 

the  element.  Gl3,...,Gl6;  G17 . G20;  and  G21....G32  are  in 

the  same  direction  with  Gl,  G13,  G17,  and  G21  along  the  same 
edge . 

2.  There  is  no  non- structural  mass. 

3.  The  quadrilateral  faces  need  not  be  planar. 

4.  Stresses  are  given  in  the  basic  coordinate  system. 

5.  All  four  continuations  are  required. 

6.  No  physical  property  of  this  element  can  be  used  as  a  local 
design  variable  in  automated  design. 
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Input  Data  Entry  CMASS1  Scalar  Mass  Connection 


EID  Element  identification  number  (Integer  >  0) . 


PID  Identification  number  of  a  PMASS  property  entry  (Default  is 

EID)  (Integer  >  0). 

GlfG2  Geometric  grid  point  identification  number  (Integer  >  0). 

C1,C2  Component  number  (6  >  Integer  >  0). 

TMAX  The  maximum  mass  value  allowed  in  design. 

Remarks : 

1.  Scalar  points  may  be  used  for  G1  and/or  G2,  in  which  case  the 
corresponding  Cl  and/or  C2  must  be  zero  or  blank.  Zero  or 
blank  may  be  used  to  indicate  a  grounded  terminal  G1  or  G2 
with  a  corresponding  blank  or  zero  Cl  or  C2.  A  grounded 
terminal  is  a  point  whose  displacement  is  constrained  to 
zero. 

2.  The  two  connection  points  (Gl,  Cl)  and  (G2 ,  C2) ,  must  be 

distinct.  Except  in  unusual  circum  winces,  one  of  them  will 
be  a  grounded  terminal  with  blank  entries  for  G  and  C. 

3.  The  TMAX  value  is  used  only  for  shape  function  design  varia¬ 
ble  linking. 
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Input  Data  Entry  CMASS2  Scalar  Mass  Property  and  Connection 


Description :  Defines  a  scalar  mass  element  of  the  structural  model  without 

reference  to  a  property  entry. 

Format  and  Examples: 


1  2.3  4  5  6  7  8  9  10 


CMASS2 

EID 

M 

Gl 

Cl 

G2 

C2 

TMIN 

TMAX 

1 

CMA.SS2 _ 

2 

9.25 

6 

_ 

Field 

EID 

M 

G1  ,G2 
C1,C2 
TMIN, TMAX 


Contents 

Element  identification  number  (Integer  >  0). 

The  value  of  the  scalar  mass  (Real). 

Geometric  grid  point  identification  number  (Integer  >  0) . 
Component  number  6  >  Integer  >  0) . 

The  minimum  and  maximum  mass  values  in  design. 


Remarks : 

1.  Scalar  points  may  be  used  for  G1  and/or  G2,  in  which  case  the 
corresponding  Cl  and/or  C2  must  be  zero  or  blank.  Zero  or 
blank  may  be  used  to  indicate  a  grounded  terminal  Gl  or  G2 
with  a  corresponding  blank  or  zero  Cl  or  C2.  A  grounded 
terminal  is  a  point  whose  displacement  is  constrained  to 
zero. 


2.  This  single  card  completely  defines  the  element  since  no 
material  or  geometric  properties  are  required. 

3.  The  two  connection  points  (Gl,  Cl)  and  (G2,  C2) ,  must  be 

distinct.  Except  in  unusual  circumstances,  one  of  them  will 
be  a  grounded  terminal  with  blank  entries  for  G  and  C. 

4.  The  TMIN  and  TMAX  values  are  used  only  for  shape  function 
design  variable  linking. 
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Input  Data  Entry  C0NM1  Concentrated  Mass  Element  Connection,  General 

Form 

Description:  Defines  a  6  x  6  symmetric  matrix  at  a  geometric  grid  point  of 

the  structural  model. 

Format  and  Examples: 


1  2 _ 3 _ 4  5  6  7  8 _ 2 _ 10. 


C0NM1 

1  EID _ 

G 

VH'H 

Mil 

M21 

M2  2 

M31 

M32 

mmm: 

C0NM1 

■  22— 

ro 

2.9 

<?■? 

-±i — 1 

itch 

M41_ ...  1 

M42 

M43 

LM44 _ 

M51 

M52 

M53 

i±i _ 

mwm 

mi 

-t2 _ 1 

1771 

1771 

1771 

■TT79 

i  ■ 

■ 

■  ■ 

mwm 

■m 

■ 

■  ■ 

■ 

■ 

wrwm 

Field 


Contents 


EID 

G 

CID 

Mij 

Remarks 


Element  identification  number  (Integer  >  0). 

Grid  point  identification  number  (Integer  >  0). 

Coordinate  system  identification  number  for  the  mass  matrix 
(Integer  >  0) . 

Mass  matrix  values  (Real). 

1.  For  a  less  general  means  of  defining  concentrated  mass  at 
grid  points,  see  C0NM2. 


2.  No  physical  property  of  this  element  can  be  used  as  a  local 
design  variable  for  automated  design. 
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Input  Data  Entry  C0NM2  Concentrated  Mass  Element  Connection,  Rigid  Body 

Form 

Description:  Defines  a  concentrated  mass  at  a  grid  point  of  the  structural 

model . 

Format  and  Examples: 


Field  Contents 

EID  Element  identification  number  (Integer  >  0) . 


G 

CID 


M 


Grid  point  identification  number  (Integer  >  0). 

Coordinate  system  identification  number  (Integer  >0).  A  CID 
of  -1  (integer)  allows  the  user  to  input  XI,  X2,  X3  as  the 
center  of  gravity  location  in  the  basic  coordinate  system. 

Mass  value  (Real) . 


X1,X2,X3  Offset  distances  from  the  grid  point  to  the  center  of  gravity 

of  the  mass  in  the  coordinate  system  defined  in  field  4, 
unless  CID  -  -1,  in  which  case  XI,  X2,  X3  are  the  coordinates 
of  the  center  of  gravity  of  the  mass  in  the  basic  coordinate 
system  (Real). 


Iij  Mass  moments  of  inertia  measured  at  the  mass  c.g.,  in  coordi¬ 

nate  system  defined  by  field  4  (Real).  If  CID  -  -1,  the 
basic  coordinate  system  is  implied. 

TMIN.TMAX  The  minimum  and  maximum  mass  values  for  design. 

Remarks 

1.  The  continuation  entry  may  be  omitted. 

2.  If  CID  -  -1,  offsets  are  internally  computed  as  the  differ¬ 
ence  between  the  grid  point  location  and  XI,  X2,  X3.  The 
grid  point  locations  may  be  defined  in  a  nonbasic  coordinate 
system.  In  this  case,  the  values  of  Iij  must  be  in  a  coordi¬ 
nate  system  that  parallels  the  basic  coordinate  system. 


I 


I 


I 


I 


! 


I 


I 
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3.  The  form  of  the  inertia  matrix  about  its  c.g.  is  taken  as: 

M 

M 

M 

Ill 
-121 
-131 

where  M  -  Jpdv 

Ill  -  J>(x2  +  x2)dv 

122  -  JV(X2  +  x2)dv 

133  -  J>(x2  +  x2)dv 

121  -  Jpx^X2dv 

131  -  Jpx]X3dv 

132  -  Jpx2X3dv 

and  xi ,  X2,  X3  are  components  of  distance  from  the  c.g.  in 
the  coordinate  system  defined  in  Field  4.  The  negative  signs 
for  the  off-diagonal  terms  are  supplied  by  the  program.  A 
warning  message  is  issued  if  the  inertia  matrix  is  non¬ 
positive  definite,  as  this  may  cause  fatal  errors  in  dynamic 
analysis  modules. 

4.  For  design,  the  mass  moments  of  inertia  must  be  zero. 

5.  The  TMIN  and  TMAX  values  are  used  only  for  shape  function 
design  variable  linking. 


SYM 

122 

-132  133 
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Input  Data  Entry  CONROD  Rod  Element  Property  and  Connection 

Description :  Defines  a  rod  element  of  the  structural  model  without  reference 

to  a  property  entry. 

Format  and  Examples : 


CONROD 

■3?>H 

_  G1 

G2 

MID 

Li _ 

c 

m 

ESTCiV 

CONROD 

2 

16 

17 

23 

mmm 

1 CONT 

1  TMIN  1 

K7.V4 

I  I 

I  I 

I  I 

I  ■ 

|  I 

I  I 

1  ■ 

■ 

IHfll 

1 

Field  Contents 

EID  Element  identification  number  (Integer  >  0). 

G1,G2  Grid  point  identification  numbers  of  connection  points 

(Integer  >  0) 

MID  Material  identification  number  (Integer  >  0). 

A  Area  of  rod  (Real). 

J  Torsional  constant  (Real). 

C  Coefficient  for  torsional  stress  determination  (Real). 

NSM  Nonstructural  mass  per  unit  length  (Real). 

TMIN.TMAX  Minimum  and  maximum  allowable  cross-sectional  areas  in  design 

(Real  >  0.0  or  blank) 

Remarks : 

1.  For  structural  problems,  CONROD  entries  may  only  reference 
MAT1  material  entries. 

2.  The  continuation  entry  is  optional. 


3.  TMAX  and  TMIN  are  ignored  unless  element  is  linked  to  global 
design  variable  through  an  ELIST  entry. 


Input  Data  Entry  CONVERT 

Description:  Defines  conversion  factors  for  various  physical  quantities. 

Fornat  and  Examples: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

FACTOR 

FACTOR 

FACTOR 

FACTOR 

CONT  1 

CONVERT 

1  HASS 

-Q  >00259 

L_J 

L_J 

CONT 

OUANT 

FACTOR 

QUANT 

FACTOR 

-etc- 

Field  Contents 

QUANTi  A  character  string  identifying  the  physical  quantity  to  be 

converted 


-  MASS,  VELOCITY 

FACTOR  The  conversion  factor  (Real  ]  0.0) 


Remarks : 


A 


1.  Any  number  of  valid  quantity -factor  combinations  can  be 
entered  on  a  single  entry. 

2.  Only  MASS  and  VELOCITY  are  currently  valid  quantity  entries. 

3.  Input  mass  values  will  be  multiplied  by  the  input  factor. 
Input  velocities  will  be  multiplied  by  the  factor. 
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Input  Data  Entry  CORD 1C  Cylindrical  Coordinate  System  Definition, 

Form  1. 

Description:  Defines  a  cylindrical  coordinate  system  by  reference  to  three 

grid  points.  These  points  must  be  defined  in  coordinate 
systems  whose  definition  does  not  involve  the  coordinate 
system  being  defined.  The  first  point  is  the  origin,  the 
second  lies  on  the  z-axis,  and  the  third  lies  in  the  plane  of 
the  azimuthal  origin. 

Format  and  Examples: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

CID 

Gl 

G2 

■939 

1  Gl  1 

1  G2  1 

1  G3  1 

1 _ 1 

ICORDIC 

3 

16 

32 

19 

■  ■ 

■ 

■ 

■  ■ 

■ 

Field  Contents 

CID  Coordinate  system  identification  number  (Integer  >  0) 

Gl,  G2,  G3  Grid  point  identification  number  (Integer  >0;  G1  *  G2  *  G3) . 


z 


Remarks : 

1.  Coordinate  system  identification  numbers  on  all  C0RD1R, 
C0RD1C,  CORDIS,  C0RD2R,  C0RD2C ,  and  C0RD2S  entries  must  be 
unique . 

2.  The  three  points  Gl,  G2 ,  and  G3  must  be  noncollinear . 

The  location  of  a  grid  point  (P  in  the  sketch)  in  this 
coordinate  system  is  given  by  (R,  6,  Z)  where  6  is  measured 
in  degrees. 


3. 


4.  The  displacement  coordinate  directions  at  P  are  dependent  on 
the  location  of  P  as  shown  above  by  (ur,  ug ,  uz). 

5.  Points  on  the  z-axis  may  not  have  their  displacement  direc¬ 
tions  defined  in  this  coordinate  system  since  an  ambiguity 
results. 

6.  One  or  two  coordinate  systems  may  be  defined  on  a  single 
entry. 
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Input  Data  Entry  C0RD1R  Rectangular  Coordinate  System  Definition,  Form  1. 

Description:  Defines  a  rectangular  coordinate  system  by  reference  to  three 

grid  points.  These  points  must  be  defined  in  coordinate 
systems  whose  definition  does  not  involve  the  coordinate 
systems  defined.  The  first  point  is  the  origin,  the  second 
lies  on  the  z-axis,  and  the  third  lies  in  the  x-z  plane. 

Format  and  Examples: 


123456789  10 


CORD1R 

CID 

Gl 

G2 

G3 

1  CID 

1  Gl 

1  G2  1 

1  G3  1 

1 _ 1 

C0RD1R 

_ 2 _ 

16 

32 

19 

Field 


Contents 


CID  Coordinate  system  identification  number  (Integer  >  0) 

Gl,  G2,  G3  Grid  point  identification  number  (Integer  >0;  G1  G2  G3). 


z 


Remarks : 

1.  Coordinate  system  identification  numbers  on  all  C0RD1R, 
C0RD1C,  CORDIS,  C0RD2R,  C0RD2C,  and  C0RD2S  entries  must  be 
unique . 

2.  The  three  points  Gl,  G2,  and  G3  must  be  noncollinear. 

3.  The  location  of  a  grid  point  (P  in  the  sketch)  in  this 
coordinate  system  is  given  by  (X,  Y,  Z) . 

4.  The  displacement  coordinate  directions  at  P  are  shown  above 
by  (ux,  uy,  uz). 

5.  One  or  two  coordinate  systems  may  be  defined  on  a  single 
entry . 
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Input  Data  Entry  CORDIS  Spherical  Coordinate  System  Definition,  Form  1. 

Description:  Defines  a  spherical  coordinate  system  by  reference  to  three 

grid  points.  These  points  must  be  defined  In  coordinate 
systems  whose  definition  does  not  Involve  the  coordinate 
systems  defined.  The  first  point  Is  the  origin,  the  second 
lies  on  the  z-axls,  and  the  third  lies  In  the  plane  of  the 
azimuthal  origin. 


Field  Contents 

CID  Coordinate  system  identification  number  (Integer  >  0) 

Gl,  G2,  G3  Grid  point  identification  number  (Integer  >  0;  Gl  **  G2  *  G3) . 


z 


Remarks : 

1.  Coordinate  system  Identification  numbers  on  all  C0RD1R, 
C0RD1C,  CORDIS,  C0RD2R,  C0RD2C ,  and  C0RD2S  entries  must  be 
unique . 

2.  The  three  points  Gl,  G2 ,  and  G3  must  be  noncollinear . 

3.  The  location  of  a  grid  point  (P  In  the  sketch)  In  this 
coordinate  system  Is  given  by  (R,  0,  where  0  and  ^  are 
measured  in  degrees. 


4.  The  displacement  coordinate  directions  at  P  are  dependent  on 
the  locations  of  P  as  shown  above  by  (ur>  uq,  u^) . 

5.  Points  on  the  polar  axis  may  not  have  their  displacement 
direction  defined  in  this  coordinate  system  since  an  ambigui¬ 
ty  results. 

6.  One  or  two  coordinate  systems  may  be  defined  on  a  single 
entry. 
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Input  Data  Entry  CORD 2 C  Cylindrical  Coordinate  System  Definition,  Form  2. 

Description:  Defines  a  cylindrical  coordinate  system  by  reference  to  the 

coordinates  of  three  grid  points.  The  first  point  defines  the 
origin.  The  second  point  defines  the  direction  of  the  z-axis. 
The  third  lies  in  the  plane  of  the  azimuthal  origin.  The 
reference  coordinate  system  must  be  Independently  defined. 

Format  and  Examples: 


1  2  3  4  .5,6  7  .8  9  ,  10 


CORD 2 C 

CID 

RID 

Al 

A2 

A3 

B1 

B2 

B3 

CONT 

GQBI22£ _ 

_1 _ 

17 

.  -2,9 

,.L  0.- 

0.0 

-1,-6 

0.0 

_L.Q _ 

-121  . 

COOT 

Cl 

C2 

C3 

1 

±21 _ 

5-2 

1.0 

-  -2.9. 

rigid 

CID 

RID 


A1,A2,A3 

B1.B2.B3 

C1.C2.C3 


Contents 

Coordinate  system  identification  number  (Integer  >  0) 

Reference  to  a  coordinate  system  which  is  defined  independ¬ 
ently  of  new  coordinate  system  (Integer  >  0  or  blank) 


Coordinates  of  three  points  in  coordinate  system  defined  in 
field  (Real). 


Remarks : 


1.  Continuation  card  must  be  present. 


2.  The  three  points  (Al,  A2 ,  A3),  (B1.B2.B3),  (C1.C2.C3)  must  be 
unique  and  noncollinear . 


3.  Coordinate  system  identification  numbers  on  C0RD1R,  C0RD1C, 
CORDIS,  C0RD2R,  CORD2C,  and  C0RD2S  cards  must  all  be  unique. 

4.  An  RID  of  zero  references  the  basic  coordinate  system. 

5.,  The  location  of  a  grid  point  (P  in  the  sketch)  in  this 
coordinate  is  given  by  (R,  6,  Z)  where  8  is  measured  in 
degrees . 

6.  The  displacement  coordinate  directions  at  P  are  dependent  on 
the  location  of  P  as  shown  above  by  (ur,  ug,  uz). 

7.  Points  on  the  z-axis  may  not  have  their  displacement  direc¬ 
tion  defined  in  this  coordinate  system  since  an  ambiguity 
results . 
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Input  Data  Entry  C0RD2R  Rectangular  Coordinate  System  Definition, 

Form  2. 

Description:  Defines  a  rectangular  coordinate  system  by  reference  to  coordi¬ 

nates  of  three  points.  The  first  point  defines  the  origin. 
The  second  defines  the  direction  of  the  z-axis.  The  third 
point  defines  a  vector  which,  with  the  z-axis,  defines  the  x-z 
plane.  The  reference  coordinate  system  must  be  independently 
defined. 

Fornat  and -Examples : 


Field 


Contents 


CID  Coordinate  system  identification  number  (Integer  >  0) 

RID  Reference  to  a  coordinate  system  which  is  defined  independ¬ 

ently  of  new  coordinate  system  (Integer  >  0  or  blank) 


Al.A2.A3 

B1,B2,B3  Coordinates  of  three  points  in  coordinate  system  defined  in 

C1,C2,C3  field  3  (Real) 
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Remarks : 

1.  The  continuation  card  must  be  present. 

2.  The  three  points  (Al,  A2,  A3),  (Bl,  B2,  B3),  (Cl,  C2 ,  C3) 
must  be  unique  and  noncollinear . 

3.  Coordinate  system  identification  numbers  on  all  C0RD1R, 
CORDlC,  CORDIS,  C0RD2R,  C0RD2C ,  and  C0RD2S  cards  must  be 
unique . 

4.  An  RID  of  zero  references  the  basic  coordinate  system. 

5.  The  location  of  a  grid  point  (P  in  the  sketch)  in  this 
coordinate  system  is  given  by  (X,  Y,  Z) . 

6.  The  displacement  coordinate  directions  at  P  are  shown  by 

(  Ujj  ,  Uy  ,  UZ  )  . 
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Input  Data  Entry  C0RD2S  Spherical  Coordinate  System  Definition,  Form  2. 

Description:  Defines  a  spherical  coordinate  system  by  reference  to  the 

coordinates  of  three  points.  The  first  point  defines  the 

origin.  The  second  point  defines  the  direction  of  the  z-axis. 
The  third  lies  in  the  plane  of  the  azimuthal  origin.  The 
reference  coordinate  system  must  be  independently  defined. 

Fonwt  and  Examples: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

C0RD2S 

CID 

RID 

A1 

A2 

A3 

B1 

B2 

B3 

CQNT 

CQRD2S _ 

3 

17 

_-2.9 

1.0 

0.0 

3.6 

0.0 

1J) 

123 

COST 

Cl 

_C2 

C3 

±22 _ 

5.2 

-L,q 

-2.9- 

Field  Contents 

C1D  Coordinate  system  identification  number  (Integer  >  0) 

RID  Reference  to  a  coordinate  system  which  is  defined  independ¬ 

ently  of  of  new  coordinate  system  (Integer  >  0  or  blank) 

A1.A2.A3 

B1,B2,B3  Coordinates  of  three  points  in  coordinate  system  defined  in 

Cl ,C2 ,C3  field  3  (Real) 


z 
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Remarks : 


1.  The  continuation  card  must  be  present. 


2.  The  three  points  (Al,  A2 ,  A3),  (Bl,  B2,  B3) ,  (Cl,  C2,  C3) 
must  be  unique  and  noncollinear . 

3.  Coordinate  system  identification  numbers  on  all  C0RD1R, 
C0RD1C ,  CORDIS,  C0RD2R,  C0RD2C  and  C0RD2S  cards  must  be 
unique . 

4.  An  RID  of  zero  references  the  basic  coordinate  system. 

5.  The  location  of  a  grid  point  (P  in  the  sketch)  in  this 
coordinate  system  is  given  by  (R,  9,  <f> )  where  9  and  d  are 
measured  in  degrees . 

6.  The  displacement  coordinate  directions  at  P  are  shown  above 
by  (ur,  U0,  u^). 

7.  Points  on  the  polar  axis  may  not  have  their  displacement 
directions  defined  in  this  coordinate  system  since  an  ambigu¬ 
ity  results. 


Input  Data  Entry  C0DMEM1  Isoparametric  Quadrilateral  Element  Connection 
Description:  Defines  the  isoparametric  quadrilateral  membrane  element. 

Ettniflt,  IDd  Exiles  : 


_ 1 _ 

2 

3 

4 

5 

6 

7 

8 

9 

EID 

PID 

G1 

1  G2  1 

G3 

G4 

T< 

TMAX 

i 

72 

—13,  _ 

_  13.„ 

mrm 

_JL5_ 

.  16., 

21L2 

i 

Field  CanSfinfcS 

EID  Element  identification  number  (Integer  >  0). 

PID  Identification  number  of  a  PQDMEM1  property  card  (Default  is 

EID)  (Integer  >  0) . 


G1,G2,G3,G4  Grid  point  identification  numbers  of  connection  points 

(Integer  >0) 

TH  Material  property  orientation  angle.  If  TH  is  real,  the 

sketch  below  gives  the  sign  convention  for  TH.  If  TH  is  an 
Integer,  the  material  x-axis  is  along  the  x-axis  of  coordi¬ 
nate  system  identified  by  the  integer. 


TMAX 

Maximum  allowable  element  thickness  in  design 
blank) . 

(Real  >  0.0  or 

1. 

Grid  points  G1  through  G4  must  be  ordered 
around  the  perimeter  of  the  element. 

consecutively 

2. 

All  interior  angles  must  be  less  than  180  . 

3. 

TMAX  is  ignored  unless  element  is  linked  to 
variable  by  an  ELIST  entry. 

global  design 
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Input  Data  Entry  CQUAD4  Quadrilateral  Element  Connection 


Description:  Quadrilateral  plate  element  (QUAD4)  of  the  structural  khI* 

This  is  an  isoparametric  membrane -bending  element. 

Format  and  Examples: 


l  2  _3  4  5  6  7  8  9  _  1M 


wmm 

FJTB 

pi 

■79 

■39 

mm 

97HB 

wrrrg 

•5IETEB1 

m 

■7S 

mmm 

IUM 

BT321 

BV'I 

wicm 

Br ,  *  **1VB 

M  M 

■791 

■79 

■S9 

■91 

1  | 

B9 

BBB 

Tmmmm 

BHB 

■bh 

HITHI 

mmm 

B1EZM 

■  ■ 

■  ■ 

9MB 

Field 


Contents 


EID 

PID 


Ci 


ZOFF 

TM 


TMAX 

Ti 


Element  identification  number  (Integer  >  0) 

Identification  number  of  a  PSHELL,  PCOMP,  PCOMP1  or  PCONP2 , 
entry  (Default  is  EID)  (Integer  >  0). 

Grid  point  identification  numbers  of  connection  points 
(Integer  >  0) . 

Offset  of  the  element  mid  plane  from  the  plane  of  grid  points 
(Real  or  blank,  see  Remark  2  for  default) . 

Material  property  orientation  specification  (Real  or  blank 
or  0  <  Integer  <  1,000,000).  If  Real  or  blank,  specifies 
the  material  property  orientation  angle  in  degrees.  If 
Integer,  the  orientation  of  the  material  x-axis  is  along  the 
projection  outo  the  plane  of  the  element  of  the  x-axis  of  the 
coordinate  system  specified  by  the  integer  value. 

Maximum  allowable  element  thickness  in  design  (Real  >  0.0) 

Membrane  thickness  of  element  at  grid  points  Gi  (Real  or 
blank,  see  Remark  3  for  default) . 


Remarks : 


1.  The  QUAD4  geometry,  coordinate  systems  and  numbering  are 
showed  in  the  figure  below: 
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The  material  coordinate  system  (TM)  and  the  offset  (ZO)  may 
also  be  provided  on  the  PSHELL  entry  for  non-composite 
elements.  The  property  data  will  be  used  if  the  correspond¬ 
ing  field  on  the  CQUAD4  entry  is  blank. 

The  Ti  are  optional,  if  not  supplied  they  will  be  set  to  the 
value  of  T  specified  on  the  PSHELL  entry.  In  such  cases,  the 
continuation  entry  is  not  required. 

TMAX  is  ignored  unless  the  element  is  linked  to  the  global 
design  variables  by  an  ELIST  entry. 
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Input  Data  Entry  CROP  Rod  Element  Connection 

Description:  Defines  a  tension-compression-torsion  element  (ROD)  of  the 

structural  model. 

Format  and  Examples: 


Field 

EID 

PID 

G1  ,G2 

TMAX 

Remarks : 

1 

2 

Contests 

Element  identification  number  (Integer  >  0). 

Identification  number  of  a  PROD  property  entry  (Default  is 
EID)  (Integer  >  0) . 

Grid  point  identification  numbers  of  connection  points 
(Integer  >  0) 

Maximum  allowable  rod  area  in  design  (Real  >  0.0  or  Blank). 

See  CONROD  for  alternative  method  of  rod  definition. 

Only  one  ROD  element  may  be  defined  on  a  single  entry. 


3.  TMAX  is  ignored  unless  the  element  is  linked  to  global  design 
variables  by  an  ELIST  entry. 


Input  Data  Entry  CSHEAR  Shear  Panel  Element  Connection 

Description:  Defines  a  shear  panel  element  (SHEAR)  of  the  structural  model. 


Format  and  Examples: 


1 _  2  3  4  ,  5  6  7  8  9  10 


mwm 

frn 

mm 

■rag 

■ 

— r 

■3H 

■ 

SS 

Field 


Contents 


EID 

PID 

G1,G2,G3,G4 

TMAX 
Remarks : 

1. 

2. 

3. 


Element  identification  number  (Integer  >  0). 

Identification  number  of  a  PSHEAR  property  entry  (Default  is 
EID)  (Integer  >  0) . 

Grid  point  identification  numbers  of  connection  points 
(Integer  >0) 

Maximum  allowable  thickness  in  design  (Real  >  0.0  or  blank). 

Grid  points  Gl  through  G4  must  be  ordered  consecutively 
around  the  perimeter  of  the  element. 

All  interior  angles  must  be  less  than  180°. 

TMAX  is  ignored  unless  element  is  linked  to  global  design 
variables  by  an  ELIST  entry. 
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Input  Data  Entry  CTRMEM 

Description;  Defines  TRMEM  constant  strain  triangular  membrane  element. 
Format  and  Examples: 


1 

2 

3 

4 

5 

6 

7 

_ 8 _ 

9 

Blw 

1  CTRMEM  J 

1  EID  J 

1  PID _ 1 

G1 

G2 

G3 

THETA 

■m 

i 

wTTTpTB 

■m 

mmm 

__l _ 

7 

12 

Held 


Contents 


EID  Element  identification  number  (Integer  >  0). 

PID  Identification  of  PTRMEM  entry  (Integer  >  0)  Default  -  EID. 

G1,G2,G3  Grid  point  identifications  of  connection  points  (Inte¬ 

ger  >  0) . 


THETA 


TMAX 
Remarks : 


Material  orientation  angle  (Real)  OR  0  <  Integer  <  1,000,000 
If  integer,  then  material  x-axis  lies  along  x-axis  of  coordi 
nate  system  identified  by  the  integer. 

Maximum  allowable  thickness  in  design. 


1.  The  TMAX  value  is  used  only  for  shape  function  design  varia¬ 
ble  linking. 
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Input  Data  Entry  DCONAIJ. 

Description:  Defines  an  aileron  effectiveness  constraint,  of  the  form: 

AE  <  AEREQ  (UPPER)  or  AE  >  AEREQ  (LOWER) 


where, 


SID  Aerodynamic  set  identification  for  the  imposed  constraint 

(Integer  >  0) . 

CTYPE  Constraint  type;  either  UPPER  for  upper  bound  or  LOWER  for 

lower  bound  (Text,  Def  -  LOWER). 

AEREQ  Required  aileron  effectiveness.  (Real  *  0.0) 

Remarks: 

1.  The  aileron  effectiveness  constraint  will  only  be  applied  if 
called  out  in  the  Solution  Control  and  if  a  lateral,  zero 
degree  of  freedom  aeroelastic  trim  analysis  is  being  per¬ 
formed. 

2.  A  LOWER  bound  constraint  excludes  all  values  to  the  left  of 
AEREQ  on  a  real  number  line,  while  an  UPPER  bound  constraint 
excludes  all  values  to  the  right,  irrespective  of  the  sign  of 
AEREQ. 


Input  Data  Entry  DCONCLA 

Description:  Defines  a  flexible  lift  curve  slope  constraint  of  the  form: 

CIA  <  CIAREQ  or  CIA  >  CLAREQ 


where , 

CIA  -  (^f/^I^r 

the  ratio  of  flexible  to  rigid  lift  curve  slopes. 
Format  and  Examples: 


1 

2 

3 

4 

5 

6 

1 

8  9_ 10 

DCONCLA 

SID 

CTYPE 

CLAREQ 

1  B 

DCONCLA  _ 

25 

UPPER 

■■  ■■ 

If 


field 

SID 

CTYPE 

CIAREQ 
Remarks : 


Contents 

Aerodynamic  set  identification  for  the  imposed  constraint 
(Integer  >0) 

Constraint  type;  either  UPPER  for  upper  bound  or  LOWER  for 
lower  bound  (Text ,  Def  -  LOWER) . 

Required  flexible-to-rigid  lift  curve  slope.  (Real  +  0.0) 


1.  This  entry  imposes  a  lift  effectiveness  only  if  called  out  in 
the  Solution  Control  and  if  a  lift  or  lift/pitching  moment 
aeroelastic  trim  analysis  is  being  performed. 

2.  A  LOWER  bound  constraint  excludes  all  values  to  the  left  of 
CLAREQ  on  a  real  number  line,  while  an  UPPER  bound  constraint 
excludes  all  values  to  the  right,  irrespective  of  the  sign  of 
CIAREQ. 
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Input  Data  Entry  DCONDSP 

Description:  Defines  a  deflection  constraint  of  the  form: 

Ajuj  <  «all  (UPPER  BOUND)  or  Ajuj  >  6all  (LOWER  BOUND) 
Format  and  Examples: 


1 

_ 2 _ 

_ 3 _ 

_ 4 _ 

_ 5 _ 

_ 6 _ 

7 

8 

9 

WTrrm 

PTTHI 

G 

C 

A 

Bni 

mwm 

V7T3I 

._22_| 

3-—J 

2  J> _ J 

Ul£L_ 

Field 

CTSET 

DCID 

CTYPE 

DALL 

LABEL 

G 

C 

A 

Remarks : 


gg.atenLg 

Constraint  set  identification  number  (Integer). 

Constraint  identification  number  (Integer). 

Constraint  type,  either  UPPER  or  LOWER  bound  (Text,  Def  - 
UPPER) . 

Allowable  displacement  (Real). 

User  specified  label  to  identify  constraint. 

Grid  identification. 

Component  number  -  any  one  of  digits  1-6. 

Real  coefficient. 


1.  Both  upper  and  lower  bounds  on  the  deflections  can  be  speci¬ 
fied  by  this  entry.  E.g.,  if  constraints  of  the  form  |u|  < 
2.0  are  to  be  imposed,  one  DCONDSP  entry  would  use  CTYPE  - 
UPPER,  DALL  -  2.0,  G  -  32,  C  -  3,  A  -  1.0  while  a  second 
entry  would  use  CTYPE  -  LOWER,  DALL  -  -2.0,  G  -  32,  C  -  3,  A 
-  1.0. 

2.  Twist  constraints  can  be  specified  by  differencing  two 
displacements  while  camber  constraints  can  be  expressed  as  a 
weighted  sum  of  three  displacements. 

3.  Any  number  of  continuation  cards  are  permitted. 

4.  A  LOWER  bound  constraint  excludes  all  values  to  the  left  of 
DALL  on  a  real  number  line,  while  an  UPPER  bound  constraint 
excludes  all  values  to  the  right,  irrespective  of  the  sign  of 
DALL. 
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Input  Data  Entry  DCONFLT 


Description:  Defines  a  flutter  constraint  in  the  form  of  a  table: 

<7  -  7REq)/(CFACT)  £  0.0 

Format  and  Examples: 


Field 

SID 

GFACT 

Vi 

GAM! 
Remarks : 


Contents 

Constraint  set  Identification,  the  constraints  are  referenced 
by  the  design  constraint  id  in  solution  control. 

Constraint  scaling  factor  (Real  >0.0,  D  -  0.10). 

Velocity  value  (Real). 

Required  damping  value  (Real). 


1.  A  negative  value  of  GAMi  refers  to  a  stable  system. 

2.  The  Vj  must  be  in  either  ascending  or  descending  order. 

3.  Linear  interpolation  is  used  to  determine  GAMA  for  a  given 
velocity. 

4.  At  least  two  pairs  must  be  entered. 

5.  Jumps  between  two  points  (Vj  -  V^+i)  are  allowed,  but  not  at 
the  end  points. 
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Input  Data  Entry  DCONFRO 

Description:  Defines  a  frequency  constraint  of  the  form: 


f  ^  fall  or  f  >  fall 
Format  and  Examples: 


1 _ _ _ 2 _ ,3  4  5 _  6 _ Z _ 8 _  9 _  1 a 


n 

im 

■■■ 

mmm 

■■f 

•»aI1  • 

■ 

■m 

KKSH 

■  ■ 

■  ■ 

■  ■ 

■  ■ 

Field 

SID 

MODE 

CTYPE 

FRQALL 
Remarks : 


Cgntentg 

Constraint  set  identification  (Integer). 

Modal  number  of  the  frequency  to  be  constrained  (Integer). 

Constraint  type,  either  UPPER  for  upper  bounds  or  LOWER  for 
lower  bounds  (Text,  Def  -  LOWER). 

Frequency  constraint  (in  Hz.).  (Real  >0.0) 

1.  More  than  one  constraint  can  be  placed  on  a  mode. 
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Input  Data  Entry  DCONSTR 


Description:  Defines  stress/strain  constraints. 

Format  and  Examples: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

DCONSTR 

MID 

—CRIT  _ 

-MID 

1  CRIT  1 

MID 

CRIT 

MID 

CRIT 

DCONSTR 

__1 _ 

VMISES 

-  10 

Field  Contents 

HID  Material  identification  number  for  the  constrained  elements. 

CRIT  Failure  criterion  to  be  used  (Text) 

Remarks : 

1.  Allowable  constraint  criteria  (CRIT)  are:  VMISES,  TSAIWU, 

STRAIN 

(A)  von  Hises  stress  constraint.  Yield  values  are  given  by 
ST,  SC  and  SS  values  on  a  MAT1  or  MAT2  data  entry. 

(B)  Tsai-Wu  stress  constraint.  Yield  values  are  given  on 
the  MAT8  data  entry. 

(C)  Maximum  strain  constraint.  Strain  allowables  for 
tension,  compression  and  shear  are  given  defined  in  the 
ST,  SC  and  SS  fields  of  a  MAT1 ,  MAT2  or  MAT8  data  entry. 
The  shear  strain  allowable  is  used  only  for  the  shear 
element  and  is  ignored  for  other  element  types. 
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Input  Data  Entry  DCONTHK  Thickness  constraints 


Description:  Defines  a  list  of  elements  (linked  using  ELIST  entries)  for 

which  thickness  constraints  are  to  be  retained  on  all  design 
iterations. 

Format  and  Examples: 


Altsraftt*  Fom: 


Field  Contents 

ETYPE  Character  input  identifying  the  element  type.  One  of  the 

following: 

BAR 

C0NM2 

ELAS 

MASS 

QDMEM1 

QUAD4 

ROD 

SHEAR 

TREMEM 

EID  Element  identification  number  (Integer  >  0  or  blank) 

Remarks • 

1.  The  purpose  of  this  bulk  data  list  is  to  ensure  that  adequate 
physical  move  limits  are  retained  in  optimization  with  shape 
function  design  variable  linking  without  requiring  retention 
of  all  move  limits.  For  problems  with  large  numbers  of  local 
variables  using  shape  functions,  the  move  limits  often  cause 
too  many  minimum  thickness  constraints  (see  Remark  2)  to  be 
retained  in  the  optimization  task.  Using  this  bulk  data 
entry  to  name  "critical"  minimum  guage  constraints  (see 
Remark  3)  will  cause  only  the  named  elements'  thickness 
constraints  to  be  computed  and  retained. 

NOTE  that  an  element  with  a  violated  minimum  gauge  constraint 
will  always  be  computed  irrespective  of  the  DCONTHK  entries, 
but  may  be  deleted  in  the  constraint  deletion. 
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2.  The  global  design  variable  in  shape  function  linking  is  non¬ 
physical  and  no  reasonable  restriction  for  a  global  move 
limit  (side  constraint)  can  be  defined;  therefore,  con¬ 
straints  on  the  local  design  variables  controlled  by  shape 
functions  are  generated  by  ASTROS  to  ensure  that  the  design 
is  reasonable  (ie,  non-negative  thicknesses). 

3 .  The  DCONTHK  entry  should  select  a  minimum  number  of  elements 
linked  to  shape  functions  that  will  enable  the  optimizer  to 
select  physically  reasonable  designs  without  retaining  all 
the  minimum  thickness  constraints  (potentially  a  very  large 
number).  Typically,  this  means  N+l  elements  spread  over  the 
range  of  the  shape  function  (e.g.  span  or  chord)  where  N  is 
the  order  of  the  shape  (N-0,  UNIFORM:  N-l,  LINEAR,  etc.) 
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Input  Data  Entry  DESELM 


Description:  Designates  design  variable  properties  when  the  design  variable 

is  uniquely  associated  with  a  single  finite  element. 


Format  and  Examples: 


1 

_ 2 _ 

_ 3 _ 

_ 4 _ 

5 

_ 6 _ 

7 

8 

2 

1 DESELM 

■  • 

mrm 

njTin 

1  VMIN  1 

K'TTJI 

1  VINIT 

wmw 

imiHHi 

Pj 

Field 


Contents 


DVID 

EID 

ETYPE 

VMIN 

VMAX 

VINIT 

LAYERNUM 

LABEL 


Design  variable  identification  (Integer  >  0) . 
Element  identification  (Integer  >  0) . 

Element  type . 


Minimum 

(Default 

allowable 
-  .001). 

value 

of 

the 

design 

variable 

(Real 

>  0) 

Maximum 

(Default 

allowable 
-  1000.) 

value 

of 

the 

design 

variable 

(Real 

>  0) 

Initial  value  of  the  design  variable  (Real,  VMIN  <  VINIT  < 
VMAX). 

The  layer  number  if  a  composite  element  is  to  be  designed. 

Optional  user-supplied  label  to  define  the  design  variable 
(Text) 


Remarks: 


1.  Valid  ETYPE' s  are  CROD,  C0NR0D,  CBAR,  CSHEAR,  CTRMEM, 
CQDMEM1 ,  CQUADA,  CMASS1,  CMASS2  and  C0NM2 . 

2.  The  initial  element  size  used  in  the  structural  analysis  is 
the  product  of  the  VINIT  value  and  the  element  size  on  the 
associated  property  entry. 


Input  Data  Entry  DESVAR 

Description:  Designates  design  variable  properties. 

Format  and  Examples: 


.1 

_ 2 _ 

3 

4 

5 

6 

7 

8 

9 

DESVAR 

1  VMIN  1 

VMAX 

VINIT. 

1  LABEL  1 

i 

PESV&R 

_ 1 _ 

mra 

-,2JL- 

— Ix-Q _ 

13 

1 

Held 

DVID 

VMIN 

VMAX 

VINIT 

LAYRNUM 

LABEL 

Remarks : 


Contents 

Design  variable  identification  (Integer  >  0). 

Minimum  allowable  value  of  the  design  variable  (Real  >  0) 
(Default  -  0.001). 

Maximum  allowable  value  of  the  design  variable  (Real  >  0) 
(Default  -  1000.0). 

Initial  value  of  the  design  variable  (Real,  VMIN  <  VINIT  < 
VMAX) . 

Layer  number  if  referencing  composite  element(s). 

Optional  user  supplied  label  to  define  the  design  variable 
(Text) . 


1.  The  elements  linked  to  the  DESVAR  are  specified  using  either 
a  PLIST  or  an  ELIST  data  entry. 

2.  Shape  function  linking  (using  ELIST  entries)  will  override 
VMIN  and  VMAX  with  large  negative  and  positive  values, 
respectively. 
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Input  Data  Entry  DLAGS 

Description:  This  entry  is  used  in  conjunction  with  RLQAD1,  RL0AD2,  TLOAD1 

and  TLOAD2  data  entries  and  defines  time  lags  and  phase  lags  as 
well  as  the  set  identification  of  the  static  load. 

FgBMLt  »nd  ExWPles: 


1 

_ 2 _ 

3 

_ 4 _ 

_ 5 _ 

_ 6 _ 

_ i _ 

8 

9 

10 

DLAGS 

wwm 

LID 

K7TT1 

DLAGS 

5 

21 

wwam 

HK9 

Em 

■SKI 

lisli 

SID 

LID 

TAU 
PHASE 
Remarks : 


I 


Contents 

Identification  number  of  DLAGS  set  (Integer  >  0) 

Identification  number  of  time  (or  frequency)  independent 
applied  load  (Integer  >  0) 

Time  delay  for  the  designated  load  set  (Real) 

Phase  lag  (in  degrees)  for  the  designated  load  set  (Real) 


1.  One  or  two  dynamic  load  sets  may  be  defined  on  a  single 
entry. 

2.  Refer  to  RL0AD1 ,  RLOAD2 ,  TL0AD1  or  TLOAD2  entries  for  formu¬ 
las  which  define  the  manner  in  which  TAU  and  PHASE  are  used. 

3.  The  phase  parameter  is  used  only  in  conjunction  with  RLOADl 
and  RL0AD2  data  entries . 

4.  The  LID  set  can  refer  to  statically  applied  loads  as  well  as 
to  additional  dynamic  loads  input  on  DLONLY  entries. 

5.  TAU  and  PHASE  can  be  defaulted  to  zero,  but  LID  must  not  be 
zero. 


I 


I 
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Input  Data  Entry  DLOAD 

Description:  Defines  a  dynamic  loading  condition  for  frequency  response  or 

transient  response  problems  as  a  linear  combination  of  load 
sets  defined  via  RL0AD1  or  RL0AD2  entries  (for  frequency 
response)  or  TL0AD1  or  TL0AD2  entries  (for  transient  response). 

Format  and  Examples: 


1  2  3  4.5  6  7  8  9  10 


DLOAD 

SID 

_ s _ 

_ si _ 

Ll 

_ S2 _ 

L2 

_ S3 _ 

L3 

DLOAD 

_ 12 _ 

mwm 

6 

mwm 

_Z _ 

8 

CONT 

S4 

L4 

etc 

1 

±h _ 

--2.0 

9 

_ 1 _ 

Ei&ls* 

SID 

s 

Si 

Li 

Remarks : 


Contents 

Load  set  identification  number  (Integer  >  0) 

Scale  factor  (Real) 

Scale  Factors  (Real) 

Load  set  identification  numbers  defined  via  bulk  data  entries 
enumerated  above  (Integer  >  0) 

1.  The  load  vector  being  defined  by  this  entry  is  given  by 

[P]  -  S  S  SiLt 

i 


2.  The  Li  must  be  unique. 

3.  SID  must  be  unique  from  all  Li. 

4.  TL0AD1  and  TL0AD2  loads  may  be  combined  only  through  the  use 
of  the  DLOAD  entry. 

5.  RL0AD1  and  RL0AD2  loads  may  be  combined  only  through  the  use 
of  the  DLOAD  entry. 

6.  SID  must  be  unique  for  all  TL0AD1 ,  TL0AD2 ,  RL0AD1  and  RL0AD2 
entries . 

7.  Load  sets  must  be  selected  by  a  solution  control  command 
(DLOAD  ”  SID) . 
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Input  Data  Entry  DLOWLY 

Description:  This  entry  is  used  in  conjunction  with  the  RL0AD1,  RL0AD2, 

TL0AD1  and  TLQAD2  entries  and  defines  the  point  where  the 
dynanic  load  is  to  be  applied  with  the  scale  factor  A. 


Field 


gyntents 


Identification  number  of  DLONLY  set  (Integer  >  0) 

Grid,  extra  point  or  scalar  point  identification  number 
(Integer  >  0) 

Component  number  (1-6  for  grid  points;  blank  or  0  for  extra 
points  or  scalar  points). 

Load  factor  A  for  the  designated  coordinate  (Real) 


Remarks: 


One  or  two  load  factors  may  be  defined  on  a  single  entry. 

Refer  to  RL0AD1,  RL0AD2 ,  TL0AD1  or  TL0AD2  entries  for  the 
formulas  which  define  the  load  factor  A. 

Component  numbers  refer  to  global  coordinates. 
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Input  Data  Entry  DMI  Direct  Matrix  Input 


Used  to  input  matrix  data  base  entities  directly.  Generates  a 
matrix  of  the  form: 


A11  a12  . Aln 

a21  a22  . A2n 

[A]  “ 


Ami  . Aran 


where  the  elements  Ay  may  be  real  or  complex. 


Field 

NAME 

PREC 

FORM 

M 


Any  valid  data  base  entity  name  (Text  8) 

The  precision  of  the  matrix  entity  to  be  loaded.  Any  one  of 
the  following  character  strings:  RSP,  CSP,  RDP,  CDP. 

The  form  of  the  matrix  entity  to  be  loaded.  Any  one  of  the 
following:  REC,  SYM,  DIAG ,  IDENT. 

The  number  of  rows  in  the  matrix. 


N  The  number  of  columns  in  the  matrix. 

The  column  number  of  the  column  being  loaded. 

R £  The  row  number  of  the  first  row  in  the  string  being  loaded. 

A(Ri,Ci)  Matrix  terras. 

Remarks : 

1.  If  the  named  entity  exists,  it  will  be  flushed  and  re-loaded. 
If  the  entity  does  not  exist,  it  will  be  created. 
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2.  Column  and  row  identifiers  (C^,  Rj)  must  always  appear 
together  although  they  can  appear  in  any  two  contiguous 
fields. 

3.  Columns  must  be  loaded  in  increasing  column  number  order.  If 
more  than  one  string  is  to  be  loaded  for  a  particular  column, 
the  Cj  field  must  contain  the  same  value  as  in  the  previous 
string.  Strings  must  be  loaded  in  increasing  row  order 
without  overlap. 

4.  Complex  matrices  require  two  real  values  for  each  matrix 
term.  These  can  be  split  across  physical  entry  boundaries. 
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Direct  Matrix  Input  at  Grid  Points 


P 


Input  Data  Entry  DMIG 

Description:  Defines  structure* related  direct  input  matrices  with  terms 

located  by  external  grid/component  values . 

Format  and  Examples: 


1 _ r  2  3  4  5  6  7  8 _ 9  _  10 


■  f  ^ 

urm 

mmm 

FTTH 

H  i" 

CONT 

GCOL 

CCOL 

GROW 

CROW 

XU 

Yij 

CONT 

±fiC 

wmm 

4 

2 

IVSS 

DEF 

CONT 

GCOL 

CCOL 

GROW 

CROW 

xij 

YiJ 

CONT 

±EE _ 

■dm 

4 

Rim 

3 

EfRH 

h 


Uzte 

NAME 

PREC 

FORM 

GCOL 

CCOL 

GROW 

CROW 

Xtj  .  Yij 


figatsnta 

Any  valid  data  base  entity  name  (Text) 

The  precision  of  the  matrix  entity  to  be  loaded.  Any  one  of 
the  following  character  strings:  RSP,  RDP,  CSP,  CDP 

The  form  of  the  matrix  entity  to  be  loaded.  Any  one  of  the 
following:  REC,  SYM,  DIAG,  IDENT 

Grid,  scalar  or  extra  point  identification  for  column  index 

Component  number  for  GCOL,  0  <  CCOL  <  6  if  GCOL  is  a  grid 
point,  zero  or  blank  for  scalar  or  extra  points. 

Grid,  scalar  or  extra  point  identification  for  row  index. 

Component  number  for  GROW,  0  <  CROW  <  6  if  GROW  is  a  grid 
point,  zero  or  blank  for  scalar  or  extra  points. 

Matrix  term.  Xjj  is  real  part  for  real  or  complex  matrices. 
Yjj  is  the  imaginary  part  for  complex  matrices  and  is  ignored 
for  real  matrices. 


Remarks : 


1.  If  the  named  entity  exists,  it  will  be  flushed  and  reloaded. 
If  the  entity  does  not  exist,  it  will  be  created. 

2.  The  number  of  rows  and  columns  will  be  either  p-set  size  or 
g-set  size  depending  on  whether  the  named  entity  is  requested 
by  K2PP,  M2PP,  B2PP  or  K2GG ,  M2GG ,  B2GG . 


-J 


n 


i 


i 


« 


« 
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3.  Each  non-null  term  in  the  matrix  requires  a  continuation 
entry.  The  column  index  and  row  index  values  can  appear  any 
number  of  times  on  a  logical  entry  but  a  fatal  error  will 
occur  if  the  same  term  is  entered  more  than  once. 

4.  The  matrix  terms  can  be  entered  in  any  order. 


I 
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Input  Data  Entry  DYNRED  Dynamic  Reduction  Data 


Description:  Defines  dynamic  reduction  control  data. 

Format  and  Examples: 


123456789  10 


DYNRED 

SID 

FMAX 

NVEC 

1 

DYNRED 

_1 _ 

Field  Contents 

SID  Set  identification  number  (Integer  >  0). 

FMAX  Highest  frequency  of  interest  (Hertz)  (Real  >  0  or  blank). 

NVEC  Number  of  generalized  coordinates  desired  (Integer  >  0  or 

blank) . 


Remarks : 

1.  Dynamic  reduction  data  must  be  requested  in  the  Solution 
Control  packet  (DYNRED  -  SID). 

2.  The  user  should  select  either  an  FMAX,  or  both  the  FMAX  and 
NVEC  fields.  FMAX  should  not  be  greater  than  necessary  for 
the  specific  dynamic  analysis.  NVEC,  if  specified,  should  be 
significantly  less  than  the  size  of  the  F-set  to  realize  any 
computational  cost  savings.  NVEC  will  limit  dynamic  reduc¬ 
tion  to  using  .'fVEC  flexible  vectors. 

3.  Dynamic  reduction  transforms  the  motions  of  the  F-set  to  the 
motions  *ft  the  user  defined  A- set  plus  motions  of  generalized 
coordinates  created  in  the  process.  The  generalized  coordi¬ 
nates  represent  overall  structure  displacements  which  are 
approximate  normal  mode  shapes.  The  generalized  coordinates 
are.  identified  by  SCALAR  points  that  are  automatically 
generated.  The  SCALAR  point  ID's  begin  with  1  greater  than 
the  highest  user  GRID,  SCALAR,  or  EXTRA  point  ID. 


Input  Data  Entry  EIGR  Real  Eigenvalue  Extraction  Data 

Description:  Defines  data  needed  to  perform  real  eigenvalue  extraction. 

Fomat  and  Examples: 


Eisld 

Contents 

SID 

Set  identification  number  (Unique  integer  > 

0) 

METHOD 

Method  of  eigenvalue  extraction,  one  of  the 
or  "GIV" 

BCD  values,  "INV" 

INV  -  Inverse  power  method 

GIV  -  Given's  method 

When  METHOD  -  INV 

When  METHOD  -  GIV 

FI,  F2 

Frequency  range  of  interest 
(Real  >  0.0).  Both  must 
be  input. 

Frequency  range  of  interest  (Real  > 
0.0;  FI  <  F2).  If  ND  is  not  blank, 
eigenvectors  are  found  whose  natural 
frequencies  lie  in  the  range  between 
FI  and  F2 . 

NE 

Estimate  of  number  of  roots 
in  range  (Required) 

Not  used. 

ND 

Desired  number  of  roots. 
(Default  is  3*NE,  INV  only). 
(Integer  >  0). 

Desired  number  of  eigenvectors. 
(Integer  >0).  If  ND  is  blank  or 
zero,  the  number  of  eigenvectors  is 
determined  from  FI  and  F2. 

(Default  -  0) _ 

E  Convergence  test  (Real,  Default  -  1.0E-6) 

NORM  Method  for  normalizing  eigenvectors,  one  of  the  BCD  values, 

"MASS",  "MAX",  or  "POINT" 


MASS  -  Normalize  to  unit  value  of  the  generalized  mass 

MAX  -  Normalize  to  unit  value  of  the  largest  component  in 
the  analysis  set  (Default) 

POINT  -  Normalize  to  unit  value  of  the  component  defined  in 
fields  3  and  U  of  continuation  (defaults  to  "MAX"  if 
point  is  not  defined) 
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G 

C 

Renarks : 


Grid  or  scalar  point  identification  number  (Required  only  if 
NORM  -  "POINT"  (Integer  >  0) 

Component  number  (One  of  the  integers  1-6)  (Required  only  if 
NORM  -  "POINT"  and  G  is  a  geometric  grid  point) 


1.  Real  eigenvalue  extraction  data  sets  must  be  selected  in 
Solution  Control  (Method  -  SID)  to  be  used. 

2.  The  units  of  FI  and  F2  are  cycles  per  unit  time. 

3.  The  continuation  entry  is  not  required.  MAX  normalization  is 
then  used. 

U.  If  METHOD  -  "GIV"  all  eigenvalues  are  found. 

5.  If  METHOD  -  "GIV",  the  mass  matrix  for  the  analysis  set  must 
be  positive  definite.  Singularities  or  near-singularities  of 
the  mechanism  type  in  the  mass  matrix  will  produce  poor 
numerical  stability  for  the  GIV  method. 

6.  If  NORM  -  MAX,  components  that  are  not  in  the  analysis  set 
may  have  values  larger  than  unity. 

7.  If  NORM  -  POINT,  the  selected  component  should  be  in  the 
analysis  set.  The  program  uses  MAX  when  it  is  not  in  the 
analysis  set. 

8.  The  desired  number  of  roots  (ND)  includes  all  roots  previous¬ 
ly  found,  such  as  rigid  body  modes  determined  with  the  use  of 
the  SUPORT  entry. 
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Input  Data  Entry  et.emt.tst 

Description:  Defines  a  list  of  elements  for  which  outputs  are  desired. 

Format  and  Examples: 


1 

_ 2 _ 

_ 3 _ 

4 

5 

_ 6 _ 

7  8  9 

HTuI 

WTTM 

EID 

EID 

WTTM 

CCNT 

3 1?;)*  Mali 

WTZm 

RWTj 

■MS 

mvm 

ITS 

Sh 

EH 

MMI 

Alternate  Form 

12  3  4  5  6  7  8  9 _ IflL 


rrrm 

1  1 

ms 

mm 

J 

i*f  i H 

■MS 

PTTTnrn 

ITS 

Kii  its 

R9 

Field 

Contents 

SID 

Set  Identification  number  referenced  by 
(Integer  >  0  ) 

Solution  Control. 

ETYPE 

Character  input  identifying  the  element 
following: 

type.  One  of  the 

BAR 

ELAS 

IHEX1 

IHEX2 

IHEX3 

QDMEM1 

QUAD* 

ROD 

SHEAR 

TRMEM 

EID  Element  identification  number  (Integer  >  0  or  blank) 

Remains: 

1.  In  order  to  be  used,  the  SID  must  be  referenced  by  Solution 
Control. 

2.  Nonexistent  elements  may  be  referenced  and  will  result  in  no 
error  message. 

3.  Any  number  of  continuations  is  allowed. 
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R7TT3B 

■TTn 

rrrnni 

Field 


Contents 


DVID 

ETYPE 

EID1.EID2, 

EIDi 


Design  variable  identification  (Integer). 

Element  type  associated  with  this  list  (e.g.,  CROD) . 
Element  identification  numbers. 


PREFj 

Remarks: 


Linking  factor  for  the  associated  EID. 


1.  Allowable  ETYPES  are:  CROD,  CONROD,  CSHEAR,  CQDMEM1 ,  CQUAD4 , 
CTRMEM,  CBAR,  CMASSl  and  CMASS2 . 

2.  The  design  variable  identification  must  match  that  of  a 
design  variable  defined  as  a  DESVAR  entry. 

3.  The  linking  factors  define  a  shape  function  to  be  used  as  the 
global  design  variable. 

4.  Designed  properties  (e.g.,  thicknesses)  of  elements  listed  on 
ELIST  entries  will  be  set  to  unity  to  ensure  proper  shape 
function  definition. 


* 


« 


« 


J 
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Input  Data  Entry  EPOINT  Extra  Point  List 

Description:  Defines  extra  points  of  the  structural  model  for  use  in  dynam¬ 

ics  problems. 

Format  anti  Examples: 


12  3  4  5  6  7  8  9  _ 10 


BTTBf 

BIS 

B7S 

BFnBI 

BS 

BFT1B 

5T3Tv7®l 

■  UI'l'Sl 

BBB 

mrm 

wcwm 

JOB 

btb 

WBKk 

mm 

ICONT _ 1 

ID  1 

ID 

ID  1 

-etc- 1 

Alternate  Form 


T37TT7SBI 

BT!)B 

iiOvUidi 

HTvI 

nrrmM 

■(OI'I 

■EMI 

■MfiKUA 

■is 

rielfl 


Contents 


SETID 


Extra  point  set  identification  number  (Integer  >  0) . 


ID.ID1.ID2 


Extra  point  identification  number  (Integer  >  0;  ID1  <  ID2) 


Remarks : 

1.  The  extra  point  set  identification  is  selected  on  the  BOUNDA¬ 
RY  entry.  All  extra  points  defined  with  this  SETID  will  be 
used  in  dynamic  analyses  in  the  boundary  condition. 

2.  All  extra  point  identification  numbers  must  be  unique  with 
respect  to  all  other  structural  and  scalar  points. 

3.  This  entry  is  used  to  define  coordinates  used  in  transfer 
function  definitions  (see  TF  entry)  and  Direct  Matrix  Input. 

4.  If  the  alternate  form  is  used,  extra  points  ID1  through  ID2 
are  defined. 
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Input  Data  Entry 


FFT 

Description.  Defines  parameters  for  controlling  the  Fast  Fourier  Transforma¬ 
tion  (FFT)  during  time  domain  response  analysis. 

Format  and  Examples: 


123456789  10 


177— 

SID 

TIME 

_ NT 

RDELTF 

RF 

FRIM 

1  OTYPE 

FLIM 

tm  ■ 

3 

20. 

1.0 

■ 

■  ■ 

■  WM 

■  ■ 

■ 

Field 


Contents 


SID 

TIME 

NT 

RDELTF 

RF 

FRIM 

OTYPE 

FLIM 

Remarks : 


FFT  set  identification  number  (Integer  >  0  ) 

Length  of  time  period  to  be  analyzed  (Real  >0.0) 

Number  of  time  points  to  be  used  for  the  FFT  (Integer  >  2) 

Ratio  of  incremental  frequency  (del  F)  to  1  /  T.  See  remarks 
4  and  6.  Default  -  1.0. 

Ratio  of  total  frequency  duration  (F)  to  NT  /  2*T.  See 
remarks  5  and  6.  Default  -  1.0. 

Frequency  response  interpolation  method.  Character  string 
"LINEAR"  or  "CUBIC".  Default  is  "LINEAR." 

Type  of  response  to  be  output.  Character  string  "TIME," 
"FREQ"  or  "BOTH."  Default  is  "TIME." 

Frequency  load  interpolation  method.  Character  string 
"LINEAR"  or  "CUBIC."  Default  is  "LINEAR." 


1.  SID  must  be  selected  by  a  FFT  option  on  a  TRANSIENT  command 
in  solution  control. 

2.  TIME  is  the  period  for  periodic  dynamic  loads  defined  in  the 
time  domain.  For  non-periodic  loads,  TIME  is  the  total  time 
duration  of  the  excitation  plus  any  quiet  portion  desired  for 
response  decay.  TIME  may  be  larger  than  the  time  duration 
defined  by  TL0AD1  or  TL0AD2  data,  in  which  case  the  forcing 
function  will  be  automatically  set  to  zero  for  the  additional 
time . 

3.  NT  should  be  a  power  of  2;  i.e.,  NT  -  2**m,  m  -  1,2,...;  or 

NT  -  2,  4,  8,  ...  .  If  NT  is  not  a  power  of  2,  it  will  be 

automatically  set  to  the  next  highest  power  of  2  value. 


The  incremental  frequency,  AF,  required  by  the  FFT  algorithm, 
is  1/TIME.  The  value  of  AF  may  be  adjusted  by  the  user  with 
the  RDELTF  factor.  However,  the  most  accurate  results  are 
normally  obtained  with  the  default  case  of  RDELTF  -  1.0. 

The  frequency  duration  required  by  the  FFT  algorithm  is 
F  -  NT  /  2*T.  This  is  the  frequency  duration  used  when  the 
default  value  of  RF  -  1.0  is  used.  If  RF  <  1.0,  the  response 
between  RF  and  1.0  times  F  is  set  to  zero  when  using  the 
inverse  Fourier  transform  to  compute  time  domain  responses. 

The  frequency  list  used  in  the  frequency  response  calcula¬ 
tions  is  generated  using  a  constant  incremental  frequency  of 
del  F  -  RDELTF  *  F,  and  the  total  frequency  duration  is  F  - 
RF  *  F. 


Input  Data  Entry  FLFACT 


Aerodynamic  Physical  Data 


Description:  Used  to  specify  density  ratios,  Mach  numbers,  and  reduced 

frequencies  for  flutter  analysis. 

Format  and  Examples: 


123456789  10 


etch 

mrm 

WKM 

mm 

Km 

— 

mgm 

mmm 

■8 

Field 


Contents 


SID 


Set  identification  number  (Integer  >  0) . 


Fi 


Aerodynamic  factor  (Real). 


Bercarjcjg : 


1.  Only  the  factors  selected  by  a  FLUTTER  data  entry  will  be 
used. 

2.  Imbedded  blank  fields  are  forbidden. 


3.  Parameters  must  be  listed  in  the  order  in  which  they  are  to 
be  used  within  the  looping  of  flutter  analysis. 

4.  All  FLFACT  entries  having  the  same  SETID  will  be  treated  as  a 
single  set. 
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Input  Data  Entry  FLUTTER  Aerodynamic  Flutter  Data 
Description:  Defines  data  needed  to  perform  flutter  analysis. 

Format  and  Examples: 


■1 

KIM 

wrzm 

■row 

2221 

wrrm 

■hb 

■ 

mwm 

wwm 

mmm 

im 

■  ■ 

k'ivUiM  ■ 

_ _ 1 

wnm 

KHI 

Field 


Contents 


SID 

METHOD 

DENS 

MACH 

VEL 

MLIST 

EPS 


Set  identification  number  (Integer  >  0). 

Flutter  analysis  method,  "PK"  for  PK-method, 

Identification  number  of  an  FLFACT  data  entry  specifying 
density  ratios  to  be  used  in  flutter  analysis  (Integer  >  0). 

Identification  number  of  an  FLFACT  data  entry  specifying  Mach 
numbers  (m)  to  be  used  in  flutter  analysis  (Integer  >  0  or 
the  Mach  No.,  Real) 

Identification  number  of  an  FLFACT  data  entry  specifying  the 
velocities  to  be  used  in  flutter  analysis.  (Integer  >  0). 

Identification  number  of  a  SETl  entry  containing  a  list  of 
normal  modes  to  be  deleted  in  flutter  analysis  (Integer  >  0) . 

Convergence  parameter  for  k;  (Real,  default  -  1.0E  5) 


SYMXZ,  SYMXY  Symmetry  flags 


Eemarkg : 


1.  The  FLUTTER  data  entry  must  be  selected  in  the  solution 
control  packet. 


2.  The  density  is  given  by  DENS*RHOREF,  where  RHOREF  is  the 
reference  value  given  on  the  AERO  data  entry,  and  DENS  is  the 
density  ratio  given  in  the  FLFACT  entry. 

3.  If  the  MLIST  is  blank,  all  the  normal  modes  computed  will  be 
retained  in  the  flutter  analysis. 

4.  An  eigenvalue  is  accepted  in  the  PK-method  when 
I k'^estimate I  ^  EPS 

5.  The  symmetry  flags  will  be  used  to  select  the  appropriate 
unsteady  aerodynamic  matrices  generated  from  the  list  of  m-k 
pairs  for  each  symmetry  option  given  on  the  MKAEROi  entries. 
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6.  If  only  one  Mach  number  is  desired,  it  may  be  placed  directly 
in  field  5  of  this  entry. 
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Input  Data  Entry  FORCE  Static  Load 

Description:  Defines  a  static  load  at  a  grid  point  by  specifying  a  vector. 

Format  and  Examples: 


1 _ 2  3  4 _ 5  6  7 _ 8  9  10 


WTFM 

WVFM 

WTM 

■m 

mrm 

■  ■ 

m 

■s 

n 

mwm 

■  ■ 

■  ■ 

Elfild 

SID 

G 

CID 

F 


g<?D£ept§ 

Load  set  identification  number  (Integer  >  0) 

Grid  point  identification  number  (Integer  >  0) 

Coordinate  system  identification  number  (Integer  >  0,  or 
blank)  (Default  -  0) 

Scale  factor  (Real) 


Nl,  N2,  N3  Components  of  a  vector  measured  in  the  coordinate  system 

defined  by  CID  (Real;  must  have  at  least  one  nonzero  compo¬ 
nent) 


Remarks : 

1.  The  static  load  applied  to  grid  point  G  is  given  by 

{f)  -  F  IN) 

where  (N)  is  the  vector  defined  in  fields  6,7  and  8. 

2.  A  CID  of  zero  references  the  basic  coordinate  system. 
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Input  Data  Entry  F0RCE1  Static  Load,  Alternate  Form  1 


Description:  Used  to  define  a  static  load  by  specification  of  a  value  and 

two  grid  points  which  determine  the  direction. 

Format  and  Examples: 


1  ?. _ 3  4  5  6  7  8  9  10 


KM 

KM 

wn 

KE3^I 

■M 

1  ■ 

1 

MM 

ni 

KM 

Ml 

ITS 

■  ■ 

■ 

■KHi 

MM 

Field 

SID 

G 

F 

Gl,  G2 
Remarks : 


Contents 

Load  set  identification  number  (Integer  >  0) 

Grid  point  identification  number  (Integer  >  0) 

Magnitude  of  load  (Real) 

Grid  point  identification  numbers  (Integer  >0;  Gl  h  G2) 

1.  The  direction  of  the  force  is  determined  by  the  vector  from 
Gl  to  G2 . 
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Input  Data  Entry  FREQ 

Description:  Defines  a  set  of  frequencies  to  be  used  in  the  solution  of 

frequency  response  problems. 

Format  and  Examples: 


123456789  _ 10 


wtrm 

ni 

n 

K9 

mi 

h^UI 

■hhi 

nm 

im 

vm 

vm 

mn 

wmm 

mrm 

mrm 

hhhi 

n 

■I  I 

1  I 

g  ■ 

|  ■ 

Mm 

wzwm 

wrwm 

KTHl 

■ 

■ 

■ 

■  ■ 

■ 

field 

SID 

F 

Remarks : 


i 

i 


Contents 

Frequency  set  identification  number  (Integer  >  0) 

Frequency  value  (Real  >  0.0) 

1.  The  units  for  the  frequencies  are  cycles  per  unit  time. 

2.  Frequency  sets  must  be  selected  by  the  Solution  Control 
(FSTEP-SID)  to  be  used. 

3.  All  FREQ,  FREQ1  and  FREQ2  entries  with  the  same  frequency  set 
identification  numbers  will  be  used.  Duplicate  frequencies 
will  be  ignored,  f^  and  fj$_l  are  considered  duplicated  if 

|fN  -  fN.i|  <  10'5  *(fMAX  * 


338 


Input  Data  Entry  FREQ1 

Description:  Defines  a  set  of  frequencies  to  be  used  In  the  solution  of 

frequency  response  problems  by  specification  of  a  starting 
frequency,  frequency  increment,  and  number  of  increments 
desired. 

Format  and  Examples: 


1  -  2  3  4  5  6  7  8  910 


Km 

ISI 

wmm 

EX9 

Held 

SID 

FI 

DF 

NDF 

Remarks : 


Contents 

Frequency  set  identification  number  (Integer  >  0) 
First  frequency  in  set  (Real  >  0.0) 

Frequency  increment  (Real  >  0.0) 

Number  of  frequency  increments  (Integer  >  0) 


1.  The  units  for  the  frequency  FI  and  the  frequency  increment  DF 
are  cycles  per  unit  time . 

2.  The  frequencies  defined  by  this  entry  are  given  by: 
f4  -  FI  +  (i-1)  DF,  i  -  1,  NDF  +  1 

3.  Frequency  sets  must  be  selected  by  the  Solution  Control 
(FSTEP-SID)  to  be  used. 

4.  All  FREQ,  FREQl  and  FREQ2  entries  with  the  same  frequency  set 
identification  ftumbers  will  be  used.  Duplicate  frequencies 
will  be  ignored.  \f(j  and  ffj-1  are  considered  duplicated  if 
lfN  *  fN-ll  <  10-5  *(fMAX  *  fMIN>- 
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Input  Data  Entry  FRE02 


Description:  Defines  a  set  of  frequencies  to  be  used  in  the  solution  of 

frequency  response  problems  by  specification  of  a  starting 
frequency,  final  frequency,  and  number  of  logarithmic  incre¬ 
ments  desired. 

EQCBflt.  and  Ex^cles: 

1 _ 2 _ 3  4  5  6 _ z _ 8 _ 2 _ I&_ 


B3V 

V7H 

mm 

mi 

TTXWm 

SWSI 

m 

■■■ 

■  ■ 

■■■ 

■■■ 

WtM 

Ei&ld 

SID 

FI 

F2 

NF 

Remarks : 


ggnttntg 

Frequency  set  identification  number  (Integer  >  0) 
First  frequency  (Real  >  0.0) 

Last  frequency  (Real  >  0.0;  F2  >  FI) 

Number  of  logarithmic  intervals  (Integer  >  0) 


1.  The  units  for  the  frequencies  FI  and  F2  are  cycles  per  unit 
time. 

2.  The  frequencies  defined  by  this  entry  are  given  by: 

fi  -  Fl  e<l-1>d  ,  i  -  1,2 . NF  +  1 

where,  d  -  (1/NF)  log*  (F2/F1) 

For  the  example  shown,  the  list  of  frequencies  will  be  1.0, 
1.4142,  2.0,  2.8284,  4.0,  5.6569  and  8.0  cycles  per  unit 
time . 

3.  Frequency  sets  must  be  selected  by  the  Solution  Control 
(FSTEP-SID)  to  be  used. 

4.  All  FREQ,  FREQ1  and  FREQ2  entries  with  the  same  frequency  set 
identification  numbers  will  be  used.  Duplicate  frequencies 
will  be  ignored.  fw  and  ffl-i  are  considered  duplicated  if 

lfN  -  fN-ll  <  10'*  *  <fMAX  -  fMIN> 


Input  Data  Entry  FREOLIST 

Description:  Defines  a  list  of  frequencies  for  which  outputs  are  desired. 

Format  and  Examples: 


1 _  2  3  4  5  6  ,7 _ _  ,6.  3 _ „  IP 


mum 

1)1  s 

MTF7M 

nrn 

i 

V 

irrwni 

im 

■tin 

mn 

mn 

nun 

Icont  J 

FREQ 

TREQ. 

-etc- 

i  hi 

HI  ■ 

■  ■ 

■ 

■  ■ 

mm 

■h 

HI 

■  ■ 

■  ■ 

EizU 

SID 

FREQ 
Remarks : 


Contents 

Set  Identification  number  referenced  by  Solution  Control 
(Integer  >  0) 

Frequency  (in  Hertz)  at  which  outputs  are  desired.  (Real) 


1.  In  order  to  be  used,  the  SID  must  be  referenced  by  Solution 
Control . 

2.  The  nearest  frequency  to  FREQ,  either  above  or  below,  which 
was  used  in  the  Frequency  Response  analysis  will  be  used  to 
satisfy  the  output  requests. 

3.  Any  number  of  continuations  is  allowed. 
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Input  Data  Entry  GRAV  Gravity  Vector 


Description:  Used  to  define  gravity  vectors  for  use  in  determining  gravity 

loadings  for  the  structural  model. 

Format  and  Examples: 


Ei&M 

SID 

CID 

G 

Nl,  N2 ,  N3 


eqnt?n.s.s 

Set  identification  number  (Integer  >  0) 

Coordinate  system  identification  number  (Integer  >  0) 

Gravity  vector  scale  factor  (Real) 

Gravity  vector  components  (Real;  at  least  one  nonzero  compo¬ 
nent) 


BSE&lkS.: 

1.  The  gravity  vector  is  defined  by  (g)  -  G(N1,  N2 ,  N3) .  The 
direction  of  (g)  is  the  direction  of  free  fall. 

2.  A  CID  of  zero  references  the  basic  coordinate  system. 

3.  Gravity  loads  may  be  combined  with  "simple  loads"  (e.g., 
FORCE,  MOMENT)  by  specification  on  a  LOAD  entry  or  by  GRAV  - 
SID.  Gravity  loads  with  the  same  SID  as  simple  load  entries 
will  not  be  used  unless  referenced  by  one  of  these  methods. 

4.  Load  sets  must  be  selected  in  Solution  Control  to  be  used. 

5.  The  units  of  G  should  be  length/sec^  in  consistent  length 
units . 
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Input  Data  Entry  GRDSET  Grid  Point  Default 

Description:  Defines  default  options  for  fields  3,  7,  and  8  of  all  GRID 

entries. 

Format  and  Examples: 


12  3  4  5  6  7  8  9  10 


GRDSET 

CP 

PS 

GRDSET 

_ 16  - . 

32 

-3AL6- 

Field 

Contents 

CP 

Identification 

number  of 

coordinate 

system  in 

which 

the 

location  of  the 

grid  point 

is  defined 

(Integer  >  0) . 

CD 

I dent i f ic  at ion 

number  of 

coordinate 

system  in 

which 

the 

displacements  are  measured 

at  grid  points  (Integer  >  0) . 

PS 

Permanent  single -point  constraints 

associated 

with 

grid 

points  (any  of  the  digits  1-6  with  no  imbedded  blanks) 
(Integer  >0). 


Remarks : 

1.  The  contents  of  fields  3,  7,  or  8  of  this  entry  are  assumed 
for  the  corresponding  fields  of  any  GRID  entry  whose  field  3, 
7,  and/or  8  are  blank.  If  any  of  these  fields  on  the  GRID 
entry  is  blank,  the  default  option  defined  by  this  entry 
occurs  for  that  field.  If  no  permanent  single-point  con¬ 
straints  are  desired  or  one  of  the  coordinate  systems  is 
basic,  the  default  may  be  overridden  on  the  GRID  entry  oy 
making  one  of  the  fields  3,  7,  or  8  zero  (rather  than  blank). 
Only  one  GRDSET  entry  may  appear  in  the  user's  Bulk  Data 
Packet. 

2.  The  primary  purpose  if  this  entry  is  to  minimize  the  burden 
of  preparing  data  for  problems  with  a  large  amount  of  repeti¬ 
tion  (e.g.,  two-dimensional  pinned-joint  problems). 


3.  At  least  one  of  the  entries  CP,  CD,  or  PS  must  be  nonzero. 


Input  Data  Entry  GRID  Grid  Point 


Description:  Defines  the  location  of  a  geometric  grid  point  of  the  structur¬ 

al  model,  the  directions  of  Its  displacement,  and  Its  permanent 
single-point  constraints. 

Format  and  Examples: 


1 _ 23456789  10 


GRID 

mi 

CP 

XI 

X2 

X3 

CD 

PS 

GRID 

2 

3 

l.P  ■ 

mwm 

3-.0 

LLejd 

ID 

CP 


XI  ,X2 ,X3 
CD 


PS 


Remarks : 


Contents 

Grid  point  identification  number  (Integer  >  0). 

Identification  number  of  coordinate  system  in  which  the 
location  of  the  grid  point  Is  defined  (Integer  >  0  or  blank) 

Location  of  the  grid  point  In  coordinate  system  CP  (Real) . 

Identification  number  of  coordinate  system  in  which 
displacements,  degrees  of  freedom,  constraints,  and  solution 
vectors  arc  defined  at  the  grid  point  (Integer  >  0  or  blank) 

Permanent  single -point  constraints  associated  with  grid  point 
(any  of  the  digits  1-6  with  no  imbedded  blanks)  (Integer  >  0 
or  blank) 


1.  All  grid  point  identification  numbers  must  be  unique  with 
respect  to  all  other  structural  and  scalar  points. 

2.  The  meaning  of  XI,  X2  and  X3  depend  on  the  type  of  coordinate 
system,  CP,  as  follows:  (see  CORDlj ;  entry  descriptions) 


TYPE 

XI 

_  X2 

X3 

Rectangular 

X 

Y 

Z 

Cylindrical 

R 

9  (degrees) 

Z 

Spherical 

R 

9  (degrees) 

<j>  (degrees) 

3.  The  collection  of  all  CD  coordinate  systems  defined  on  all 
GRID  entries  is  called  the  Global  Coordinate  System.  All 
degrees-of-freedom,  constraints,  and  solution  vectors  are 
expressed  in  the  Global  Coordinate  System. 
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Input  Data  Entry  GRIDLIST 

Description:  Defines  a  list  of  points  at  which  outputs  are  desired. 

Format  and  Examples : 


1234. S  6789  10 


■ 

■4TM 

KW'M 

■3TM 

wzrm 

R9 

■m 

mrnrn 

■uk'ii 

HHH 

■■■ 

■■  ■ 

■  ■ 

■■m 

ICON! _ 1 

1  GID  1 

1  -etc- 

1  1 

1 

1  1 

1  1 

1  1 

1 _ 1 

■■■ 

■■■ 

■  ■ 

■  ■ 

■  ■ 

■ 

■■■ 

■  ■ 

Alternate  Form: 


1 

2 

3 

4 

5 

6 

8 

9 

10 

l  SID  J 

GID 

Uli  ;d']J 

1  GID _ 1 

1 

1 135331239 

mmm 

100 

BS33I 

wmm 

1 

Field 

SID 

GID 


Remarks : 


Contents 

Set  identification  number  referenced  by  Solution  Control 
(Integer  >  0  ) 

Grid,  scalar  or  extra  point  id  at  which  outputs  are  desired. 
(Integer  >  0  ) 


1.  In  order  to  be  used,  the  SID  must  be  referenced  by  Solution 
Control . 

2.  Nonexistent  points  may  be  referenced  and  will  result  in  no 
error  message. 

3.  Any  number  of  continuations  is  allowed. 

4.  Referenced  extra  points  will  only  appear  if  the  boundary 
condition  includes  extra  points  and  then  will  only  appear  in 
Dynamic  Response  disciplines. 


Input  Data  Entry  GUST  Aerodynamic  Gust  Load  Description 


Defines  a  stationary  vertical  gust  for  use  in  aeroelastic 
analysis . 


Held  Contents 

Gust  set  identification  number  (Integer  >  0). 

The  SID  of  a  TLOAD  or  RLOAD  data  entry  which  defines  the  time 
or  frequency  dependence  (Integer  >  0). 

Scale  factor  (gust  velocity/forward  velocity)  for  gust 
velocity  (Real  +  0) . 

Location  of  reference  plane  in  aerodynamic  coordinates 
(Real  >  0.0) . 

V  Velocity  of  vehicle  (Real  >  0.0). 

QDP  Dynamic  pressure  (Real  >  0.0). 

MACH  Mach  number  (Real  >  0.0). 

SYMXZ , SYMXY  Symmetry  flags 

Remarks : 

1.  The  GUST  entry  is  selected  as  a  discipline  option  for  FRE¬ 
QUENCY  or  TRANSIENT  in  Solution  Control. 

2.  The  gust  angle  is  in  the  +z  direction  of  the  aerodynamic 
coordinate  system.  The  value  is 


SID 

GL0AD 

WG 

XO 


where  T  is  the  tabular  function. 

3.  In  random  analysis,  a  unit  gust  velocity  (WG  -  1/velocity)  is 
suggested.  The  actual  rms  value  is  entered  on  the  TABRNDG 
data  entry. 
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4.  The  symmetry  flags  will  be  used  Co  select  Che  appropriate 
unsteady  aerodynamic  matrices  from  the  list  of  m-k  pairs  for 
each  symmetry  option  given  on  the  MKAER01  entries. 


3A7 


Input  Data  Entry  i£  Transient  Initial  Condition 

Description:  Defines  values  for  the  initial  conditions  of  coordinates  used 

in  transient  analysis.  Both  displacement  and  velocity  values 
may  be  specified  at  independent  coordinates  of  the  model. 

Format  and  Examples: 


Field  Contents 

SID  Set  identification  number  (Integer  >  0) 

G  Grid,  scalar  or  extra  point  identification  number 

(Integer  >  0) 

C  Component  number  (blank  or  zero  for  scalar  or  extra  points, 

any  one  of  the  digits  1-6  for  a  grid  point) 

UO  Initial  displacement  value  (Real) 

VO  Initial  velocity  value  (Real) 


R£n&ik£: 

1.  Transient  initial  condition  sets  must  be  selected  in  the 
Solution  Control  (IC-SID)  to  be  used. 

2.  If  no  IC  set  Is  selected,  all  initial  conditions  are  assumed 
zero. 


3.  Initial  conditions  for  coordinates  not  specified  on  IC 
entries  will  be  assumed  zero. 

4.  Initial  conditions  may  be  used  only  in  direct  formulation. 
In  a  modal  formulation  the  initial  conditions  are  all  zero. 
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Input  Data  Entry  JSET  Select  Coordinates  for  the  j-set 

Description:  Defines  degrees  of  freedom  that  the  user  desires  to  use  in  the 

computation  of  inertia  relief  mode  shape(s)  in  Dynamic  Reduc¬ 
tion. 


Format  and  Examples: 


1 

2 

_ 3 _ 

4 

5 

6 

7 

8 

9 

JSET 

SETID 

JR*! 

C 

_ ID _ 1 

C 

1  ID 

C 

1  1 

1  CONT  1 

JSET 

—  lj_ 

2 

23 

■ 

■ 

■  ■ 

■ 

ln*JCiV 

mem 

Field  Contents 


SETID 


The  set  identification  number  of  the  INERTIA  set. 


ID  Grid  or  scalar  point  identification  number  (Integer  >  0). 

C  Component  number,  zero  or  blank  for  scalar  points,  any  unique 

combination  of  the  digits  1-6  for  grid  points. 

Remarks : 

1.  Coordinates  specified  on  this  entry  form  members  of  a  mutual¬ 
ly  exclusive  set.  They  may  not  be  specified  on  other  entries 
that  define  mutually  exclusive  sets. 

2.  When  JSET  and/or  JSET1  entries  are  present,  all  degrees  of 
freedom  not  otherwise  constrained  will  be  placed  on  the  o- 
set . 


3.  Use  of  JSET  in  dynamic  reduction: 

a.  JSET  defines  the  structural/non-structural  j-set  degrees 
of  freedom  (inertia  relief  shapes).  An  alternate  input 
format  is  provided  by  the  JSETl  entry. 

b.  The  SID  is  selected  by  the  Solution  Control  Command 
BOUNDARY  INERTIA  -  n. 

c.  Use  "0"  as  the  grid  point  identification  number  to  select 
the  origin  of  the  basic  coordinate  system  as  the  j-set 
degrees  of  freedom. 

4.  Any  number  of  continuations  are  allowed. 
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Input  Data  Entry  JSET1  Select  Coordinates  for  the  j-set,  Alternate  Form 

Description:  Defines  degrees  of  freedom  that  the  user  desires  to  use  in  the 

computation  of  inertia  relief  mode  shape (s)  in  Dynamic  Reduc¬ 
tion. 

Format  and  Examples: 


1 

_ 2 _ 

3 

4 

5 

6 

7 

8 

9 

10 

JSETl 

C 

G 

G 

G 

G 

G 

G 

CONT 

JSETl _ 

BBS 

_ 2 _ 

_1 _ 

_J _ 

10 

9 

6 

ABC 

■m 

mnm 

Alternate  Form: 


i 

2 

3 

4 

5 

6 

7 

8 

9 

10 

JSETl 

Lsetid  1 

1  C  1 

IDl 

"THRU" 1 

1  ID2 _ 1 

JSETl _ 

_z _ 

ffil 

Fie.U 


Contents 


SETID 


The  INERTIA  set  identification  number 


C  Component  number  (any  unique  combination  of  the  digits  1-6 

(with  no  imbedded  blanks)  when  point  identification  numbers 
are  grid  points;  must  be  blank  or  zero  if  point  identifica¬ 
tion  numbers  are  scalar  points. 

G,  ID1,  ID2  Grid  or  scalar  point  identification  numbers  (Integer  >  0, 

ID1  >  ID2) , 

Remarks : 

1.  Coordinates  specified  on  this  entry  form  members  of  a  set 
that  is  exclusive  from  other  sets  defined  by  bulk  data 
entries . 


2.  When  JSET  and/or  JSET1  entries  are  present,  all  degrees  of 
freedom  not  otherwise  constrained  will  be  placed  in  the 
o-set. 


3.  If  the  alternate  form  is  used,  all  points  in  the  sequence  ID1 
through  ID2  are  required  to  exist. 

4.  Use  of  JSET1  in  dynamic  reduction: 

a.  JSETl  defines  the  structural  and  non-structural  j-set 
degrees  of  freedom  (inertia  relief  shapes).  An  alternate 
input  format  is  provided  by  the  JSET  entry. 

b.  The  SID  is  selected  by  Solution  Control  Command  BOUNDARY 
INERTIA  -  n. 
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c.  Use  "0"  as  the  grid  point  Identification  number  to  select 
the  origin  of  the  basic  coordinate  system  as  the  j-set 
degrees  freedom. 
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L  Jt  I- 


L*  N*. 


Input  Data  Entry  LOAD  Static  Load  Combination  (Superposition) 

Description:  Defines  a  static  load  as  a  linear  combination  of  load  sets 

defined  via  FORCE,  MOMENT,  F0RCE1,  MOMENT1 ,  PLOAD,  and  GRAV 
entries . 


Format  and  Examples: 


1  2  3  4  5  6  7  8  9  IQ 


LOAD 

SID 

S 

SI 

LI 

S2 

L2 

S3 

L3 

CONT 

LOAD 

-Ifll 

_ iQ .  5.- 

,  1.0 

3 

6.2 

4 

4.5 

10 

ABC  , . 

CONT 

S4 

L4 

+BC 

2.3 

H5 

-etc- 

Field  Content? 


SID 

s 

Si 

Li 

Remarks : 


Load  set  identification  number  (Integer  >  0) 

Scale  factor  (Real) 

Scale  factors  (Real) 

Load  set  identification  numbers  defined  via  data  entry  types 
enumerated  above  (Integer  >  0) 

1.  The  load  vector  defined  is  given  by 

{P>  -  S  S  Si  {Li ) 

2.  The  Li  must  be  unique.  The  remainder  of  the  physical  entry 
containing  the  last  entry  must  be  blank. 

3.  Load  sets  must  be  selected  in  the  Solution  Control  if  they 
are  to  be  applied  to  the  structural  model. 

4.  A  LOAD  entry  may  not  reference  a  set  identification  number 
defined  by  another  LOAD  entry. 


352 


4 


CONT 

ST 

_ SC ..... 

.  ss 

|  ■ 

1  ■ 

■  ■ 

■  ■ 

■ 

1  9 

+BC 

20. +4 

racs 

EERS 

■  ■ 

■  ■ 

■ 

■ 

■ 

■ 

field 


Contents 


MID 

E 

G 

NU 

RHO 

A 


TREF 

GE 


ST,  SC,  SS 


Material  identification  number  (Integer  >0) 

Young's  modulus  (Real  or  blank) 

Shear  modulus  (Real  or  blank) 

Poisson's  ratio  (-1.0  <  Real  <  0.5  or  blank) 

Mass  density  (Real  >  0.0). 

Thermal  expansion  coefficient  (Real) 

Thermal  expansion  reference  temperature  (Real) 

Structural  element  damping  coefficient  (Real) 

Stress  limits  for  tension,  compression,  and  shear  (Real).  Used  to 
compute  margins  of  safety  in  certain  elements  and  to  compute 
stress/strain  constraints. 


Remarks : 


1.  The  material  identification  number  must  be  unique  for  all 
MAT1,  MAT2,  MAT8  and  MAT9  bulk  data  entries. 

2.  The  mass  density,  RHO,  will  be  used  to  automatically  compute 
mass  for  all  structural  elements. 

3.  Weight  density  may  be  used  in  fields  6  if  the  value  1/g  is 
entered  on  the  CONVERT  entry  where  g  is  the  acceleration  of 
gravity. 

4.  Either  E  or  G  must  be  specified  (i.e.,  nonblank). 

5.  If  any  one  of  E,  G,  or  NU  is  blank,  it  will  be  computed  to 

satisfy  the  identity  E  -  2  *(1+NU)*G;  otherwise,  values 

supplied  by  the  user  will  be  used. 


•m 
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6.  If  E  and  Nil  or  G  and  NU  are  both  blank,  they  will  both  be 
given  the  values  0.0. 

7.  Implausible  data  on  one  or  more  KA.T1  entries  will  result 
in  a  warning  message.  Implausible  data  are  defined  as  any 
of  E  <  0.0  or  G  <  0.0  or  NU  >  0.5  or  NU  <  0.0  or  |1  - 
E/[2(1+NU)G] |  >  0.01  except  for  cases  covered  by  Remark  6. 

8.  It  is  strongly  recommended  that  only  two  of  the  three  values 
E,  G,  and  NU  be  input.  The  three  values  may  be  input  inde¬ 
pendently  on  the  MAT2  entry. 
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Input  Data  Entry  MAT 2  Material  Property  Definition,  Form  2 


Defines  the  material  properties  for  linear,  temperature -inde¬ 
pendent,  anisotropic  materials  for  two-dimensional  elements. 


4.  2x2  matrices  (for  example,  transverse  shear)  use  elements 
Gn ,  G^2*  and  ^22-  For  this  case.  G33  must  be  blank. 

5.  If  the  MAT2  entry  is  referenced  by  the  PCOMP  entry,  the 
transverse  shear  flexibility  for  the  referenced  laminae  is 
zero . 


355 


Unlike  the  MATl  entry,  data  from  the  MAT2  entry  are  used 
directly,  without  adjustment  of  equivalent  E,  G,  or  NU 
values . 


Input  Data  Entry  MAT 8 


Material  Property  Definition,  Form  8 


Description:  Defines  the  material  property  for  an  orthotropic  material. 

Format  and  Example: 


1 _ .  2  3.  4  5  6  7,  8  910 


■5BHI 

wa wm 

ITU 

mvim 

mnm 

mmm 

im 

ftRll 

Mika 

C0NT 

Al 

A2 

TREF 

_ Xt _ 

_ Xc _ 

_ Yt _ 

.  Yc 

_ ss 

CONT  I 

+ABC 

run 

wmm 

nun 

mm a 

8+2 

n mm 

■FJTJI 

hbs 

Field  Contents 

MID  Material  ID  (Integer  >  0) 

El  Modulus  of  elasticity  in  longitudinal  direction  (also  defined  as 

fiber  direction  or  1-direction)  (Real  +  0.0) 

E2  Modulus  of  elasticity  in  lateral  direction  (also  defined  as 

matrix  direction  or  2-direction)  (Real  *  0.0) 

NU12  Poisson's  ration  [(c2)/(cl)  f°r  uniaxial  loading  in  1-direc¬ 

tion].  Note  that  NU21  -  (ei)/(c2)  for  uniaxial  loading  in  2- 
direction  is  related  to  NU12 ,  El,  E2  by  the  relation  NU12*E2  - 
NU21*E1 .  (Real) 

G12  Inplane  shear  modulus  (Real  >  0.0) 

G^t2  Transverse  shear  modulus  for  shear  in  1-Z  plane  (Real  >  0.0  or 

blank)  (default  implies  infinity) 

G2  z  Transverse  shear  modulus  for  shear  in  2-Z  plane  (Real  >  0.0  or 

blank)  (default  implies  infinity) 

RHO  Mass  density  (Real) 

A1  Thermal  expansion  coefficient  in  1-direction  (Real) 

A2  Thermal  expansion  coefficient  in  2-direction  (Real) 

TREF  Thermal  expansion  reference  temperature  (Real) 

Xt,  Xc  Allowable  stresses  in  tension  and  compression,  respectively,  in 

the  longitudinal  direction.  Required  if  failure  index  is  desired 
or  if  element  stress/strain  is  constrained  in  design.  (Real  > 
0.0)  (Default  value  for  Xc  is  Xt) 
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Yt.  Yc 

SS 

Ge 

F12 

Remarks : 


Allowable  stresses  In  tension  and  compression,  respectively,  in 
the  transverse  direction.  Required  if  failure  index  is  desired 
or  if  the  element  stress/strain  is  constrained  in  design.  (Real 
>0.0)  (Default  value  for  Yc  is  Yt) 

Allowable  stress  for  inplane  shear  (Real  >  0.0) 

Structural  damping  coefficient  (Real) 

Interaction  term  in  the  tensor  polynominal  theory  of  Tsai-Wu 
(Real).  Required  if  failure  index  or  stress  constraint  by  Tsai- 
Wu  theory  is  desired  and  if  value  of  F]^  is  different  from  0.0. 


1.  If  2  an<*  G2  Z  values  are  specified  as  zero,  or  are  not 
supplied,  transverse  shear  flexibility  calculations  will  not 
be  performed. 

2.  An  approximate  value  for  G^  2  and  G2  Z  in-plane  shear 

modulus  Gi2*  If  test  data  are  not  available  to  accurately 
determine  G^  2  and  G2  Z  f°r  material  and  transverse  shear 
calculations  are  deemed  essential,  the  value  of  G^2  may 
supplied  for  G12  and  G2,Z- 

3.  Xt,  Xc,  Yt,  Yc  and  SS  are  used  for  composite  element  failure 
calculations  when  requested  in  the  "F.T."  field  of  the  PCOMP^ 
entries. 


358 


- 


Input  Data  Entry  MAT 9 


Material  Property  Definition,  Form  9 


Description:  Defines  the  material  properties  for  linear,  temperature- inde 

pendent,  anistropic  materials  for  solid  isoparametric  elements.  | 

E9.ma^...an4-g2iang>,l.e : 


i 


i 


Field 

MID 

Gij 

RHO 

Ai 

TREF 


Contents 

Material  identification  number  (Integer  >  0) 

Elements  of  the  6x6  symmetric  material  property  matrix  (Real) 
Mass  density  (Real  >0.0) 

Thermal  expansion  coefficient  vector  (Real) 

Thermal  expansion  reference  temperature  (Real) 


GE  Structural  element  damping  coefficient  (Real) 

Remarks : 


1.  The  material  identification  numbers  must  be  unique  for  all 
MAT1 ,  MAT2 ,  MAT8 ,  and  MAT9  cards. 

2.  The  mass  density  RHO  will  be  used  to  automatically  compute 
mass . 

3.  Continuation  number  4  need  not  be  used. 
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4.  The  subscripts  1  through  6  refer  to  x,  y,  z,  xy,  yz,  zx,  e.g: 


G11 

G12 

G22 

SYM 

G13 

G23 

G33 

G14 

G24 

G34 

G44 

G15 

G25 

G35 

G45 

G55 

Gl6 

G26 

G36 

G46 

G56 

5.  To  obtain  the  damping  coefficient,  GE,  multiply  the  critical 
damping  ratio,  C/Cq,  by  2.0. 
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Input  Data  Entry  MFORM  Mass  Matrix  Form 


Description:  Defines  the  form  of  the  mass  matrix  as  consistent  (coupled)  or 

lumped. 

Format  and  Example: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

MFORM 

VALUE 

1 

MFORM 

LUMPED 

Field  Contents 

VALUE  A  character  string  denoting  the  form  of  the  mass  matrix.  The 

t  available  forms  are 

1)  LUMPED 

2)  COUPLED 

Remarks : 

1.  If  more  than  one  MFORM  is  included  in  the  Bulk  Data,  any 
COUPLED  value  will  result  in  coupled  mass  being  used. 

2.  If  no  MFORM  is  indicated,  the  LUMPED  formulation  will  be 
used. 

I 


I 
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Input  Data  Entry  MKAEROI  Mach  Number  -  Frequency  Table 


Description:  Provides  a  table  of  Mach  numbers  (m)  and  reduced  frequencies 

(k)  for  unsteady  aerodynamic  matrix  calculation. 

Format  and  Examples: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

_ 10  : 

MKAEROI 

SYMXZ 

SYMXY 

mi 

■2 

m3 

m^ 

m5 

<"6 

CONT 

1 

n 

0.7 

+ABC 

■ 

■ 

- 

CONT 

kl 

k2 

k3 

k4 

k5 

k6 

k7 

k8 

+ABC 

.3 

-6 

in 

Field  Consents 

SYMXZ, SYMXY  Symmetry  flags  (Integer).  See  Remarks  5  and  6. 
m^  List  of  from  1  to  6  Mach  numbers  (Real  >0.0) 

kj  List  of  from  1  to  8  reduced  frequencies  (Real  >0.0) 

Remarks: 

1.  All  combinations  of  (m,k)  will  be  used. 

2.  The  continuation  entry  is  required. 

3.  Several  MKAEROi  entries  may  be  in  the  input  packet.  If  these 
data  entries  are  in  the  packet,  they  will  be  used  to  generate 
aerodynamic  matrices . 

4.  The  first  imbedded  value  of  either  m  or  k  that  is  zero  for  a 
given  entry  will  be  interpreted  as  zero,  a  subsequent  zero 
(or  blank)  will  end  the  table.  Values  of  0.0  or  blank  that 
end  either  the  m  list  or  k  list  will  be  ignored.  If  only  a 
single  zero  value  of  either  m  or  k  is  desired,  use  the 
MKAER02  entry. 

5.  The  symmetry  flags  have  the  following  definition: 

+1  for  symmetric  (not  available  for  SYMXY) 

0  for  asymmetric 
-1  for  antisymmetric 

The  m-k  pairs  generated  by  this  entry  will  generate  aerody¬ 
namic  matrices  having  the  symmetries  selected. 

6.  m-k  pairs  may  be  repeated  with  different  symmetry  options. 

7.  The  following  are  the  restrictions  associated  with  the 
symmetry  flags: 
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(a)  Ground  effect  (if  present)  is  limited  to  antisymmetric 
only.  SYMXY  -  0  or  -1 

(b)  Ground  effect  is  not  available  for  supersonic  flow. 


Input  Data  Entry  MKAER02  Hach  Number  -  Frequency  Table 


Description:  Provides  a  list  of  Mach  numbers  (m)  and  reduced  frequencies  (k) 

for  aerodynamic  matrix  calculation. 

Format  and  Examples: 


1 

2 

3 

4 

_ 5 _ 

6 

7 

8 

9 

MKAER02 

SYMXZ 

SYMXY 

mi 

n 

®2 

k2 

m3 

k3 

CONT 

MKAERQ2 

0 

-.10- 

-JO  . 

n 

mwm 

ABC 

CONT 

“4 

k4 

™3 

k5 

etc . 

+BC 

.8 

.9 

■  8 

1.0 

Field  Contents 

SYMYZ, SYMXY  Symmetry  flags  (Integer).  See  Remarks  4  and  5. 

m^.kj  List  of  pairs  of  Mach  numbers  (Real  >0.)  and  reduced  frequen¬ 

cies  (Real  >  0 . ) 


Remarks : 

1.  This  entry  will  cause  the  aerodynamic  matrices  to  be  computed 
for  the  given  sets  of  parameters. 

2.  Several  MKAEROi  entries  may  be  in  the  input  packet.  If  these 
data  entries  are  in  the  packet,  they  will  be  used. 

3.  Any  number  of  continuations  are  allowed. 

4.  The  symmetry  flags  have  the  following  definition: 

+1  for  symmetric  (not  available  for  SYMXY) 

0  for  asymmetric 
-1  for  antisymmetric 

The  m-k  pairs  listed  on  the  entry  will  generate  aerodynamic 
matrices  having  the  symmetries  selected. 

5.  m-k  pairs  may  be  repeated  with  different  symmetry  options. 

6.  The  following  restrictions  are  imposed  on  the  symmetry  flags: 

(a)  Ground  effect  (if  present)  must  be  antisymmetric. 

SYMXY  -  0  or  -1 

(b)  Ground  effect  is  not  available  for  supersonic  flow. 
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Input  Data  Entry  MODELIST 


Description:  Defines  a  list  of  modes  at  which  outputs  are  desired. 

Format  and  Example: 


1 _ _ _ 2  .  3  L  4  5  6  7  8  9  10 


MODELIST 

SID 

MODE 

MODE 

MODE 

MODE 

MODE 

MODE 

MODE 

CONT 

KQPELIST 

-JLOiL- 

1 

_2 _ 

4 

CONT 

MODE 

MODE 

•etc- 

1 

Alternate  Form: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

MODELIST 

SID 

MODE 

"THRU" 

MODE 

MODELIST 

1QP 

1 

THRU 

10 

k* 


Field  Contents 

SID  Set  identification  number  referenced  by  Solution  Control  (Integer 

>  0  ) 

MODE  Mode  number  of  mode  at  which  outputs  are  desired.  (Integer  >  0) 


Remarks : 


1.  In  order  to  be  used,  the  SID  must  be  referenced  by  Solution 
Control . 


2.  Modes  are  numbered  from  1  to  n,  starting  at  the  lowest 
frequency  for  which  a  eigenvector  was  computed. 

3.  Nonexistent  modes  may  be  referenced  and  will  result  in  no 
error  message. 

4.  Any  number  of  continuations  is  allowed. 


Input  Data  Entry  MOMENT  Static  Moment 

Description:  Defines  a  static  moment  at  a  grid  point  by  specifying  a  vector. 

Format  and  Example: 


1  2  3  4  5  6  7 _ S _ 2 _ 10 


Hy  M___J 

■rai i 

■PS 

warn 

WWW 

BUS 

HTW 

■mi 

Field 

SID 

G 

CID 

M 

Nl,  N2,  N3 


Contents 

Load  set  identification  number  (Integer  >  0) 

Grid  point  identification  number  (Integer  >  0) 

Coordinate  system  identification  number  (Integer  >  0) 

Scale  factor  (Real) 

Components  of  vector  measured  in  coordinate  system  defined  by  C ID 
(Real;  at  least  one  nonzero  component) 


Remarks : 

1.  The  static  moment  applied  to  grid  point  G  is  given  by 

(m)  -  M  (Nl,  N2 ,  N3) 

2.  A  CID  of  zero  references  the  basic  coordinate  system. 
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Input  Data  Entry  MOMENT 1  Static  Moment,  Alternate  Form  1 


Description:  Defines  a  static  moment  by  specification  of  a  value  and  two 

grid  points  which  determine  the  direction. 

Format  and  Example: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

_1Q 

MOMENT 

SID 

G 

M 

Gl 

G2 

MOMENT 

6 

-  13,. 

-2.93 

16 

,JL3  . 

Field 


Contents 


SID  Load  set  identification  number  (Integer  >  0) 

G  Grid  point  identification  number  (Integer  >  0) 

M  Magnitude  of  moment  (Real) 

Gl,  G2  Grid  point  identification  numbers  (Integer  >0;  Gl  G2) 

Remarks : 

1.  The  direction  of  the  moment  vector  is  determined  by  the 
vector  from  Gl  and  G2. 
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Input  Data  Entry  MPC  Multipoint  Constraint 

Description:  Defines  a  multipoint  constraint  equation  of  the  form: 

?  Ajuj  -  0.0 

Format  and  Example: 


1 _ 23456789  10 


MPC 

SID 

GO 

AO 

G 

C 

A 

C0NT 

MPC 

3 

—28 

3 

_JL2_ 

_ L _ 

3 

4.29 

_ 

1  ■ 

KH 

H9I 

1  ■ 

i  ■ 

eTSHHI 

IHHI 

■ni 

HEH 

wwm 

HHH 

■■ 

■■■ 

msm 

Field  Contents 


SID  Set  identification  (Integer  >  0) 

G0,G  Identification  number  of  grid  or  scalar  point  (Integer  >  0) 


C0,C  Component  number  -  any  one  of  the  digits  1-6  in  the  case  of 

geometric  grid  points;  blank  or  zero  in  the  case  of  scalar  points 
(Integer) 


A0, A  Coefficient  (Real;  A0  must  be  nonzerc), 

Remarks : 

1.  The  first  coordinate  (GO,  CO)  in  the  sequence  is  assumed  to 
be  the  dependent  coordinate.  A  dependent  degree  of  freedom 
assigned  by  one  MPC  entry  cannot  be  assigned  dependent  by 
another  MPC  entry. 

2.  Forces  of  multipoint  constraint  are  not  recovered. 

3.  Multipoint  constraint  sets  must  be  selected  in  Solution 
Control  (MPC  -  SID)  to  be  used. 

4.  The  m-set  coordinates  specified  on  this  entry  may  not  be 
specified  on  other  entries  that  define  mutually  exclusive 
sets . 
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Input  Data  Entry  MPCADD  Multipoint  Constraint  Set  Combination 


Description:  Defines  a  multipoint  constraint  set  as  a  union  of  multipoint 

constraint  sets  defined  via  MPC  entries. 

Format  and  Example: 


Field 

Contents 

SID 

Set 

identification  number  (Integer  >  0) 

Sj 

Set 

via 

identification  numbers  of  multipoint  constraint  sets  defined 
MPC  entries  (Integer  >  0) 

Remarks : 

1. 

The  Sj  must  be  unique. 

2. 

Multipoint  constraint  sets  must  be  selected  in  Solution 
Control  (MPC  -  SID)  to  be  used. 

3. 

Sj  may  not  be  the  identification  number  of  a  multipoint 
constraint  set  defined  by  another  MPCADD  entry. 

4. 

MPCADD  entries  take  precedence  over  MPC  entries.  If  both 

have  the  same  set  ID.  onlv  the  MPCADD  entrv  will  be  used. 
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Input  Data  Entry  MPPARM 


Description:  Identify  values  of  user  defined  optimizer  parameters  that 

override  the  default  values. 

Format  and  Example: 


I _ - — 2 _ , 2 _ _ r  5  6 _ Z _ § _ 9 _ la 


T.'37TJIW 

1  J'.V.VB 

rrroT: 

ITJjJJTl 

I7T7171 

mum 

M 

rrjTj-DM 

KH 

HrMH 

■■■ 

— 

■■■ 

UTT.^'l 

mtm 

ess 

g  g 

g  g 

g  g 

gg| 

g 

g  g 

BSP  ■ 

■■ 

■■ 

■ 

g 

g 

■ 

g 

g 

g 

fie 

PARAH 

VALUE 

Remarks 


Contents 

Name  of  the  parameter  to  be  overridden  (Text). 
Integer  or  real  value  to  be  used  for  the  parameter. 


1.  Any  number  of  PARAM- VALUE  combinations  can  be  specified  on  an 
MPPARM  entry. 

2.  See  EDO  software  manual  (ADS  V  1.10)  for  a  definition  of 
parameters,  but  the  most  useful  are  shown  below: 


REAL 

PARAMETER 

DEFINITION _ 

CT 

Constraint  tolerance  in  the  Method  of  Feasible 
Directions  or  the  Modified  Method  of  Feasible 
Directions.  A  constraint  is  active  if  its 
numerical  value  is  more  positive  than  CT. 

CTL 

Same  as  CT,  but  for  linear  constraints. 

CTLMIN 

Same  as  CTMIN,  but  for  linear  con  traints. 

CTMIN 

Minimum  constraint  tolerance  for  nonlinear  con¬ 
straints.  If  a  constraint  is  more  positive 
than  CTMIN,  it  is  considered  to  be  violated. 

DABOBJ 

Maximum  absolute  change  in  the  objective  between 
two  consecutive  iterations  to  indicate  conver¬ 
gence  in  optimization. 

DABOBM 

Absolute  convergence  criterion  for  the  optimi¬ 
zation  sub-problem  when  using  sequential  mini¬ 
mization  techniques. 

DABSTR 

Same  as  DABOBJ,  but  used  at  the  strategy  level. 

DELOBJ 

Maximum  relative  change  in  the  objective  between 
two  consecutive  iterations  to  indicate  conver¬ 
gence  in  optimization. 

DELOBM 

Relative  convergence  criterion  for  the  optimiza¬ 
tion  sub -problem  when  using  sequential  minimiza¬ 
tion  techniques . 

DELSTR 

Same  as  DELOBJ,  but  used  at  the  strategy  level. 

DLOBJ1 

Relative  change  in  the  objective  function 
attempted  on  the  first  optimization  iteration. 
Used  to  estimate  initial  move  in  the  one-dimen¬ 
sional  search.  Updated  as  the  optimization 
progresses . 

DLOBJ2 

Absolute  change  in  the  objective  function 
attempted  on  the  first  optimization  iteration. 
Used  to  estimate  initial  move  in  the  one-dimen¬ 
sional  search.  Updated  as  the  optimization 
progresses . 

DX1 

Maximum  relative  change  in  a  design  variable 
attempted  on  the  first  optimization  iteration. 
Used  to  estimate  the  initial  move  in  the  one¬ 
dimensional  search.  Updated  as  the  optimization 
progresses . 

DX2 

Maximum  absolute  change  in  a  design  variable 
attempted  on  the  first  optimization  iteration. 
Used  to  estimate  the  initial  move  in  the  one¬ 
dimensional  search.  Updated  as  the  optimization 
progresses . 

EXTRAP 

Maximum  multiplier  on  the  one -dimensional  search 
parameter,  ALPHA  in  the  one -dimensional  search 
using  polynomial  interpolation/extrapolation. 

SCFO 

The  user- supplied  value  of  the  scale  factor  for 
the  objective  function  if  the  default  or  calcu¬ 
lated  value  is  to  be  overridden. 

SCLMIN 

Minimum  numerical  value  of  any  scale  factor 
allowed . 

STOL 

Tolerance  on  the  components  of  the  calculated 
search  direction  to  indicate  that  the  Kuhn- 
Tucker  conditions  are  satisfied. 
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REAL 


DEFINITION 

THETAZ 

Nominal  value  of  the  push-off  factor  in  the 
Method  of  Feasible  Directions. 

XMULT 

Multiplier  on  the  move  parameter,  ALPHA,  in  the 
one-dimensional  search  to  find  bounds  on  the 
solution. 

ZRO 

Numerical  estimate  of  zero  on  the  computer. 
Usually  the  default  value  is  adequate.  If  a 
computer  with  a  short  word  length  is  used, 

ZRO  -  1.0E-4  may  be  preferred. 

INTEGER 

PARAMETER 

DEFINITION _ 

XSCAL 

Scaling  parameter.  By  default,  scaling  is  done 
every  NDV  iterations,  otherwise  scaling  is  per¬ 
formed  very  ISCAL  iterations. 

ITMAX 

Maximum  number  of  iterations  allowed  at  the  op¬ 
timizer  level. 

ITRMOP 

The  number  of  consecutive  iterations  for  which 
the  absolute  or  relative  convergence  criteria 
must  be  met  to  indicate  convergence  at  the  op¬ 
timizer  level. 

ITRMST 

The  number  of  consecutive  iterations  for  which 
the  absolute  or  relative  convergence  criteria 
must  be  met  to  indicate  convergence  at  the 
strategy  level. 

JTMAX 

Maximum  of  iterations  allowed  at  the  strategy 
level . 

Input  Data  Entry  OMIT  Omitted  Coordinates 


Description:  Defines  degrees  of  freedom  that  the  user  desires  to  omit  from 

the  problem  through  matrix  partitioning.  Used  to  reduce  the 
number  of  independent  degrees  of  freedom. 

Format  and  Example : 


1 

2 _ 

3 

4 

5 

6 

7 

8 

9 

10 

OMIT 

C 

ID 

! _ c _ 1 

ID 

C 

sans _ 

10 

16 

_ L_ 

23 

wmm 

54 

23 

| 

Field 

SETID 

ID 

C 


Remarks : 


Contents 

The  reduce  set  identification  number  (Integer  >  0). 

Grid  or  scalar  point  identification  number  (Integer  >  0) . 

Component  number,  zero  or  blank  for  scalar  points,  any  unique 
combination  of  the  digits  1-6  for  grid  points. 


1.  Coordinates  specified  on  this  entry  form  members  of  a  mutual¬ 
ly  exclusive  set.  They  may  not  be  specified  on  other  entries 
that  define  mutually  exclusive  sets. 

2.  In  many  cases  it  may  be  more  convenient  to  use  OMITl,  ASET  or 
ASET1  entries. 


1 
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Input  Data  Entry  0MIT1  Omitted  Coordinates,  Alternate  Form 


Description:  Defines  degrees  of  freedom  that  the  user  desires  to  omit  from 

the  problem  through  matrix  partitioning.  Used  to  reduce  the 
number  of  independent  degrees  of  freedom. 

Format  and  Examples: 


1 

_ 2 _ 

3 

4 

5 

6 

7 

8 

9 

10 

0MIT1 

C 

G 

G 

G 

G 

G 

G 

QMII1 _ 

3 

2 

1 

3 

10 

_ 2 _ 

6 

5 

KfUn 

CONT 

G 

G 

G 

-etc. 

I  I 

I  ■ 

1  I 

H  1 

+BC 

7 

8 

Alternate  Form 


l 

2 

3 

4 

5 

6 

7 

8 

9 

10 

0MIT1 

SETID 

C 

ID1 

1 "THRU" 1 

1 .  ID2 _ 1 

omih _ 

3 

0 

-  17 

IEET39 

■m 

Field 


Contents 


SETID  The  reduce  set  Identification  number  (Integer  >  0) . 

C  Component  number  (Any  unique  combination  of  the  digits  1-6 

(with  no  imbedded  blanks)  when  point  identification  numbers 
are  scalar  points) . 

G.ID1.ID2  Grid  or  scalar  point  identification  number  (Integer  >  0; 

ID1  <  ID2) 


Remarks : 

1.  Coordinates  specified  on  this  entry  form  members  of  a  mutual¬ 
ly  exclusive  set.  They  may  not  be  specified  on  other  entries 
that  define  mutually  exclusive  sets. 

2.  If  the  alternate  form  is  used,  points  in  the  sequence  ID1 
through  ID2  are  required  to  exist. 
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Input  Data  Entry  PAER01 


Aerodynamic  Panel  Property 


Description:  Gives  associated  bodies  for  the  panels  in  the  unsteady  aerody¬ 

namic  model . 

Format  and  Examples: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

IPAERQl  I 

PID 

Bl 

B2 

.  Bi_ 

B4 

B5 

B6 

1 

msn 

1 

3 

1 

Field 


Contents 


PID  Property  identification  number  (referenced  by  CAER01) 

(Integer  >  0) . 

B1.....B6  ID  of  CAER02  entries  for  associated  bodies  (Integer  >  0  or 

blank) . 

Remarks : 

1.  The  associated  bodies  must  be  in  the  same  aerodynamic  group. 

2.  The  Bi  numbers  above  must  appear  on  a  CAER02  entry  to  define 
these  bodies  completely. 


* 
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.—A  Ji  ...  - 


Input  Data  Entry  PAER02  Aerodynamic  Body  Properties 

Description:  Defines  the  cross-section  properties  of  unsteady  aerodynamic 

bodies . 

Format  and  Examples: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

PAER02 

PID 

1  LTH1  1 

LTH2 

CONT 

PAER02 

2 

6.0 

*T|gI 

91 

i mm 

ABC 

K!RI 

_ _ 1 

■H 

■m 

Field 


Contents 


PID 

ORIENT 


WIDTH 


Property  identification  number  (Integer  >  0) . 

Orientation  flag  "Z",  "Y" ,  or  "ZY" .  Type  of  motion  allowed 
for  bodies  (Text) .  Refers  to  the  aerodynamic  coordinate 
system  "y"  and  "z"  directions  (see  AERO  data  entry). 

Reference  half-width  of  body  (Real  >  0.0). 


AR 

LRSB 


LRIB 


Aspect  ratio  (height/width)  (Real  >  0.0). 

ID  of  an  AEFACT  data  entry  containing  a  list  of  slender  body 
half -widths.  If  blank,  the  value  of  WIDTH  will  be  used 
(Integer  >  0  or  blank). 

ID  of  an  AEFACT  data  entry  containing  a  list  of  interference 
body  half-widths.  If  blank,  the  value  of  WIDTH  will  be  used 
(Integer  >  0  or  blank) . 


LTH1 ,  LTH2 


ID  of  AEFACT  data  entries  for  defining  theta  arrays  for 
interference  calculations  (Integer  >  0). 


THIi ,  THNi 


The  first  and  last  interference  element  of  a  body  to  use  the 
theta^  array  (Integer  >  0) . 


Remarks : 

1.  The  EID  of  all  CAER02  elements  in  any  ICID  group  must  be 
ordered  so  that  their  corresponding  ORIENT  values  appear  in 
the  order  Z,  ZY,  Y. 


2.  The  half -widths  (given  on  AEFACT  data  entries  referenced  in 
fields  6  and  7)  are  specified  at  division  points.  The 
number  of  entries  on  an  AEFACT  data  entry  used  to  specify 
half -widths  must  be  one  greater  than  the  number  of  elements. 

3.  The  half-width  at  the  first  point  (i.e.,  the  nose)  on  a 
slender  body  is  usually  0.0;  thus,  it  is  recommended  (but 
not  required)  that  the  1.RSB  data  is  supplied  with  a  zero 
first  entry. 
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4.  THIi  and  THNi  are  interference  element  locations  on  a  body. 
The  element  numbering  begins  at  one  for  each  body. 

5.  A  body  is  represented  by  a  slender  body  surrounded  by  an 
interference  body.  The  slender  body  creates  the  downwash 
due  to  the  motion  of  the  body,  while  the  interference  body 
represents  the  effects  upon  panels  and  other  bodies. 


SLENDER  BODY 
(six  elements 
shown) 


INTERFERENCE  BODY 
(three  elements 
shown) 


I 


3 


END  VIEW 
(looking  forward) 


Theta  array,  receiving  points 
for  interference  body  elements 


Input  Data  Entry  PAER06 

Description:  Defines  body  analysis  parameters  for  steady  aerodynamics. 

Format  and  Examples: 


I _ 2 _ 3  4 _ 5 _ 6 _ 7 _ 8 _ 9 _ 10 


PAER06 

BCID 

CMPNT 

CP 

IGRP 

NRAD 

LRAD 

LAXIAL 

PAER06 

10 

HJSE1_ 

0 

3 

4 

Field 

BCID 

CMPNT 

CP 

IGRP 

NRAD 

LRAD 

LAXIAL 


Contents 

Body  component  ID  (Integer  >  0) 

Component  type  (FUSEL  for  the  fuselage  or  POD  for  a  POD) 
Coordinate  system  of  the  geometric  input  (Integer) 
Aerodynamic  group  flag  (Integer  >  0) 

Number  of  equal  radial  cuts  used  to  define  the  body  panels 
(Integer  >  0.0  or  blank) 

ID  of  an  AEFACT  data  entry  which  defines  the  angular  loca¬ 
tions  in  degrees  of  the  body  panels  (Integer  >  0.0  or 

blank) . 

ID  of  an  AEFACT  data  entry  which  defines  the  axial  locations 
of  the  body  panels  (Integer  >  0.0  or  blank). 


Remarks : 

1.  LRAD  is  required  only  if  NRAD  is  zero  or  blank. 

2.  LAXIAL  is  used  only  for  FUSEL  components.  Inputs  on  the 
AEFACT  entry  are  the  dimensional  fuselage  stations. 

3.  If  LAXIAL  is  blank,  the  axial  locations  are  the  same  as 
those  given  by  AXSTA  data  entries  for  the  component. 
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Input  Data  Entry  PBAR  Simple  Beam  Property 


Defines  the  properties  of  a  simple  beam  (bar)  which  Is  used  to 
create  bar  elements  via  the  CBAR  entry. 


Field 


11,12,112 


K1.K2 

Ci , Di , Ei , Fi 
R12 ,R22 .ALPHA 


Property  Identification  number  (Integer  >  0). 

Material  identification  number  (Integer  >  0). 

Area  of  bar  cross-section  (Real). 

Area  moments  of  inertia  (Real)  (1^  >  0.0,  I2  >  0.0,  I1I2  > 

Il22> 

Torsional  constant  (Real). 

Nonstructural  mass  per  unit  length  (Real) . 

The  minimum  cross--sectional  area  in  design. 

Area  factor  for  shear  (Real). 

Stress  recovery  coefficients  (Real). 

Inertia  linking  terms  for  design  (see  remarks  5  and  6). 


Remarks : 


PBAR  entries  may  only  reference  MAT1  material  entries. 

The  transverse  shear  stiffnesses  in  planes  1  and  2  are 
(Kl)AG  and  (K2)AG,  respectively.  The  default  values  for  K1 
and  K2  are  infinite;  in  other  words,  the  transverse  shear 
flexibilities  are  set  equal  to  zero.  K1  and  K2  are  ignored 
if  112  -  0. 

The  stress  recovery  coefficients  Cl  and  C2,  etc.,  are  the  y 
and  z  coordinates  in  the  BAR  element  coordinate  system  of  a 
point  at  which  stresses  are  computed.  Stresses  are  computed 
at  both  ends  of  the  BAR. 
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4.  The  TMIN  value  is  used  only  for  shape  function  design 

variable  linking. 

5.  For  design,  the  following  applies  to  the  R12  and  R22  values. 

The  moments  of  inertia  are  linked  to  the  cross-sectional 

area  by  the  following  expressions: 

11  -  R12*Aalpha 

12  -  R22*Aalpha 

(A)  If  R12  -  0.0  then  the  missing  value  is  computed  from 
R12  -  I1/(A**ALPHA) .  The  same  is  true  for  R22  and  12. 

(B)  The  ALPHA  value  defaults  to  1.0  and  must  be  >  1.0. 

(C)  If  both  11  and  R12  or  12  and  R22  are  given,  the  linking 
expression  will  override  the  input  I|  values. 

6.  If  the  CBAR  is  to  be  designed,  the  following  restrictions 

apply. 

(A)  J  -  NSM  -  K1  -  K2  -  112  -  0.0 

If  any  of  these  values  are  not  zero,  a  warning  message 
will  be  issued  and  the  value  set  to  zero. 


Input  Data  Entry  PCOMP  Layered  Composite  Element  Property 

Description :  Defines  the  properties  of  an  n-ply  composite  material  laminate. 

Format  and  Examples: 


X _ 2 _ 3  4 _ 5  6 _ 7  8 _ 9 _ 10 


PCOMP 

PID _ I 

ZO 

NSM 

F.T.  1 

KU79 

wmm 

C0NT 

PCOMP 

mzm 

1.5 

im 

EI?AI 

+ABC 

CONT 

MIDI  J 

T1 

TH1 

S0UT1 

MID2 

T2 

TH2 

S0UT2 

CONT 

+BC 

0.05 

?0,,  . 

■39 

-45. 

+DEF 

CONT 

MID3 

T3 

TH3 

S0UT3 

etc. , . 

+EF 

45.0 

Field 

PID 

ZO 

NSM 

SBOND 

F.T. 

TMIN 

LOPT 


Contents 


Property  ID  (Integer  >  0). 

Offset  of  the  element  mid-plane  from  the  bottom  surface 
(Real  or  blank,  see  Remark  2) 

Non- structural  mass  per  unit  area  (Real). 

Allowable  shear  stress  of  the  bonding  material.  (Real  >  0.0) 

Failure  theory,  one  of  the  strings  "HILL",  "HOFF”,  "TSAI", 
"STRESS",  or  "STRAIN".  See  Remark  4. 

Minimum  ply  thickness  for  design  (Real  >  0.0  or  blank). 

Lamination  generation  option,  either  the  string  "MEM"  or 
blank.  See  Remark  5. 


MIDi 


Material  identification  number  of  the  i(th)  layer.  (Integer 
>  0  or  blank) 


Ti  Thickness  of  the  i(th)  layer  (Real,  >  0.0  or  blank). 

TH^  Angle  between  the  longitudinal  direction  of  the  fibers  of 

the  i(th)  layer  and  the  material  X-axis.  (Real  or  blank) 


SOUTi 


Stress  output  request  for  i(th)  layer, one  of  the  strings 
"YES"  or  "NO".  (Default  -  "NO") 


Remarks : 


1.  For  non-designed  elements,  the  plies  are  numbered  from  1  to 
n  beginning  with  the  bottom  layer. 

2.  The  default  for  Z0  is  half  the  laminate  thickness. 
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3.  SBOND  is  required  if  bonding  material  failure  index  calcula¬ 
tions  are  desired. 

4.  The  failure  theory  is  used  to  determine  the  element  failure 
on  a  ply-by-ply  basis.  The  available  theories  are: 

HILL  -  Hill  Theory 

HOFF  -  Hoffman  Theory 

TSAI  -  Tsai-Wu  Theory 

STRESS  -  For  Maximum  Stress  Theory 

STRAIN  -  For  Maximum  Strain  Theory 

5.  MEM  indicates  a  layup  of  membrane  only  plies. 

6.  The  material  properties,  MIDI,  may  reference  only  MATl , 

MAT2,  and  MAT8  Bulk  Data  entries. 

7.  If  any  of  the  MIDI,  Ti  or  THi  are  blank,  then  the  last  non¬ 
blank  values  specified  for  each  will  be  used  to  define  the 

values  for  the  ply. 


8.  TMIN  will  be  ignored  unless  the  element  is  linked  to  design 
variables  by  ELIST  entries. 


Input  Data  Entry  PC0MP1 


Layered  Composite  Element  Property 


Description:  Defines  the  properties  of  an  n-ply  laminated  composite  materi¬ 

al  where  all  plies  are  composed  of  the  same  material  and  are 
of  equal  thickness. 

Format  and  Examples: 


1 

2 

3 

4 

5 

6 

_ 7 _ 

8 

9 

10 

PC0MP1 

1  PIP _ 1 

ZO 

NSM 

SBOND  1 

■CBS 

MID 

wrm i 

PC0MP1 

wmm 

-(LJ  

1.7 

RSI 

200 

+ABC  | 

CONT 

TH2 

TH3  l 

TH4 

TH5 

TH6 

TH7 

CONT 

+BC 

0.25 

-45.0 

45.0 

90.0  1 

90.0 

45.0 

CONT 

TH8 

TH9 

TH10 

-etc- 

Field 

PID 

ZO 

NSM 

SBOND 

F.T. 

TMIN 

MID 

LOPT 

TPLY 

THi 

Remarks : 


Contents 


Property  ID  (Integer  >  0). 

Offset  of  the  element  mid-plane  from  the  lower  surface  (Real 
or  blank,  see  Remark  2) 

Non-structural  mass  per  unit  area  (Real). 

Allowable  shear  stress  of  the  bonding  material.  (Real  > 

0.0) 

Failure  theory,  one  of  the  strings  "HILL",  "HOFF",  "TSAI", 
"STRESS",  or  "STRAIN".  See  Remark  4. 

Minimum  ply  thickness  for  design  (Real  >  0.0  or  blank). 

Material  identification  number  for  all  layers.  (Integer  >  0 
or  blank) 

Lamination  generation  option,  either  the  string  "MEM"  or 
blank.  See  Remark  5. 

Thickness  of  all  layers.  (Real  >  0.0). 

Angle  between  the  longitudinal  direction  of  the  fibers  of 
the  i(th)  layer  and  the  material  X-axis.  (Real  or  blank) 


1.  For  non-designed  elements,  the  plies  are  numbered  from  1  to 
n  beginning  with  the  bottom  layer. 

2.  The  default  for  Z0  is  half  the  laminate  thickness. 

1.  SBOND  is  required  if  bonding  material  failure  index  calcula¬ 
tions  are  desired. 
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4.  The  failure  theory  is  used  to  determine  the  element  failure 
on  a  ply-by-ply  basis.  The  available  theories  are: 

HILL  -  Hill  Theory 

HOFF  -  Hoffman  Theory 

TSAI  -  Tsai-Wu  Theory 

STRESS  -  For  Maximum  Stress  Theory 

STRAIN  -  For  Maximum  Strain  Theory 

5.  MEM  indicates  a  layup  of  membrane  only  plies. 

6.  The  material  property,  MID,  may  reference  only  MAT1,  MAT2, 
or  MAT8  Bulk  Data  entries. 

7.  TMIN  will  be  ignored  unless  the  element  is  linked  to  design 
variables  by  ELIST  entries. 


384 


Input  Data  Entry  PC0MP2 


Layered  Composite  Element  Property 


Description:  Defines  the  properties  of  an  n-ply  laminated  composite  materi¬ 

al  where  all  plies  are  composed  of  the  same  material  but  are 
of  different  thicknesses. 

Format  and  Examples: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

PC0MP2 

im 

ZO 

NSM 

SBOND 

ESS 

TMIN 

MID 

LOPT 

CONT 

PC0MP2 

100 

-0.5 

1.7 

5. +3 

K££fl 

200 

+ABC 

+BC 

Tl 

TH1 

T2 

TH2 

T3 

1  TH3  1 

ETC . . . 

+BC 

0.25 

-45.0 

0.5 

90.0 

0.25 

wzwm 

Field 


Contents 


PID 

ZO 

NSM 
SBOND 
F.  T. 

TMIN 

MID 

LOPT 

Ti 

THt 

Remarks : 


Property  ID  (Integer  >  0). 

Offset  of  the  element  mid-plane  from  the  lower  surface  (Real 
or  blank,  see  Remark  2) 

Non-structural  mass  per  unit  area  (Real) . 

Allowable  shear  stress  of  the  bonding  material.  (Real  >0.0) 

Failure  theory,  one  of  the  strings  "HILL",  "HOFF",  "TSAI", 
STRESS",  or  "STRAIN".  See  Remark  4. 

Minimum  ply  thickness  for  design  (Real  >  0.0  or  blank). 

Material  identification  number  for  all  layers.  (Integer  > 
0.0  or  blank) 

Lamination  generation  option,  either  the  string  "MEM"  or 
blank.  See  Remark  5. 

Thickness  of  the  i(th)  layer.  (Real  >  0.0  or  blank). 

Angle  between  the  longitudinal  direction  of  the  fibers  of 
the  i(th)  layer  and  the  material  X-axis.  (Real  or  blank) 


1.  For  non-designed  elements,  the  plies  are  numbered  from  1  to 
n  beginning  with  the  bottom  layer. 

2.  The  default  for  Z0  is  half  the  laminate  thickness. 

3.  SBOND  is  required  if  bonding  material  failure  index  calcula¬ 
tions  are  desired. 


4.  The  failure  theory  is  used  to  determine  the  element  failure 
on  a  ply-by-ply  basis.  The  available  theories  are: 

HILL  -  Hill  Theory 

HOFF  -  Hoffman  Theory 

TSAI  -  Tsai-Wu  Theory 

STRESS  -  For  Maximum  Stress  Theory 

STRAIN  -  For  Maximum  Strain  Theory 

5.  MEM  indicates  a  layup  of  membrane  only  plies. 

6.  The  material  property,  MID,  may  reference  only  MAT1 ,  MAT2, 
or  MAT8  Bulk  Data  entries. 

7.  If  any  of  the  Ti  or  Thi  are  blank,  then  the  last  non-blank 
values  specified  for  each  will  be  used  to  define  the  values 
for  the  ply. 

8.  TMIN  will  be  ignored  unless  the  element  is  linked  to  design 
variables  by  ELIST  entries. 


Input  Data  Entry  PELAS  Scalar  Elastic  Property 


Description :  Used  to  define  stiffness,  damping  coefficient,  and  stress 

coefficient  of  a  scalar  elastic  element  (spring)  by  means  of 
the  CELASl  entry. 

Format  and  Examples: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

WTTM 

K 

GE 

s 

TMIN 

7 

4.29 

0.06 

7.92 

Field 

PID 

K 

GE 

S 

TMIN 
Remarks : 


Contents 

Property  identification  number  (Integer  >  0) 

Elastic  property  value  (Real) 

Damping  coefficient  (Real) 

Stress  coefficient  (Real) 

Minimum  value  for  design 

1.  The  user  is  cautioned  to  be  careful  using  negative  spring 
values . 

2.  TMIN  is  ignored  unless  the  element  is  designed  using  shape 
function  design  variable  linking. 
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Input  Data  Entry  PIHEX  Isoparametric  Hexahedron  Property 

Description:  Defines  the  properties  of  an  isoparametric  solid  element, 

including  a  material  reference  and  the  number  of  integration 
points.  Referenced  by  the  CIHEX1 ,  CIHEX2,  and  CIHEX3  en¬ 
tries. 

Format  and  Examples: 


I _ 2 _ 3  4  5  6 _ Z _ § _ 9 _ IQ. 


i?ni 

n 

wnm 

rrn 

in 

wmm 

! WM 

fTTiTVH 

■n 

■ 

■ 

Field 

Contents 

PID 

Property  identification  number  (Integer  >  0) 

MID 

Material  identification  number  (Integer  >  0) 

CID 

Identification  number  of  the  coordinate  system  in  which  the 
material  referenced  by  MID  is  defined  (Integer  >  0  or  blank) 

NIP 

Number  of  integration  points  along  each  edge  of 
(Integer  -  2,  3,  4,  or  blank) 

the  element 

AR 

Maximum  aspect  ratio  (ratio  of  longest  to  shortest  edge)  of 
the  element  (Real  >  1.0  or  blank) 

ALFA 

Maximum  angle  in  degrees  between  the  normals  of 
angles  comprising  a  quadrilateral  face  (Real,  0 
180.0  or  blank) 

two  subtri- 
.0  <  ALFA  < 

BETA 

Maximum  angle  in  degrees  between  the  vector  connecting  a 
corner  point  to  an  adjacent  midside  point  and  the  vector 
connecting  that  midside  point  and  the  other  midside  or 
corner  point  (Real,  0.0  <  BETA  <  180.0  or  blank) 

Examples  of  Field  Definitions: 


Example  of  BETA 


i 
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Remarks : 


1.  All  PIHEX  cards  must  have  unique  identification  numbers. 

2.  CID  is  not  used  for  isotropic  materials. 

3.  The  default  for  CID  is  the  basic  coordinate  system. 

4.  The  default  for  NIP  is  2  for  IHEX1  and  3  for  1HEX2  and 
IHEX3 . 

5.  AR,  ALFA,  and  BETA  are  used  for  checking  the  geometry  of  the 
element.  The  defaults  are: 


C1HEX1 

C1HEX2 

CIHEX3 


AR 

ALFA 

BETA 

(degrees) 

(degrees) 

5.0 

45.0 

.... 

10.0 

45.0 

45.0 

15.0 

45.0 

45.0 

'•Til 


Input  Data  Entry  PLIST 


Description:  Defines  property  entries  associated  with  a  design  variable. 
Format  and  Examples: 


1 _ .-  23456789  10 


R7JTI 

■  JilXB 

ITJT7V 

KITES 

n 

■n 

mrm 

mrm 

ITTTTS^H 

■TTtV 

■  ^  f 

Alternate  Form: 


wmm 

V4*44m 

BTmdV 

■£■ 

■Hi 

■nsi 

■ 

■ 

■ 

Eield 

Contents 

DVID 

Property  list  identifier  (Integer). 

PTYPE 

Property  type  associated  with  this  list  (e.g.,  PROD). 

PID1.PID2, 

PID3 

Property  entry  identifications. 

Remarks : 

1. 

Allowable  PTYPES  are:  PROD,  PSHEAR,  PCOHP,  PCOMP1,  PC0MP2 , 
PSHELL,  PMASS ,  PELAS ,  PTRMEM ,  PQDMEM1 ,  and  PBAR. 

2. 

If  the  alternate  form  is  used,  PID2  must  be  greater  than  or 
equal  to  PID1. 

3. 

All  elements  using  properties  listed  as  PLIST  entries  for  a 
particular  DVID,  will  be  designed  by  (linked  to)  that  design 
variable . 
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Input  Data  Entry  PLOAD  Static  Pressure  Load 


Description:  Defines  a  static  pressure  load  on  a  triangular  or 

quadrilateral  element. 

Format  and  Examples: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

_ 10 

PLOAD  j 

SID 

P 

Gl 

G2 

G3 

G4 

.  1  _ 

PLOAD  1 

1 

.  -A,  0  .. 

16 

?2 ... 

—11.. .. 

_ _ 

Eield 

SID 

P 

Cl . G4 


Contents 

Load  set  identification  number  (Integer  >  0) 

Pressure  (Real) 

Grid  point  identification  numbers  (Integer  >  0;  G4  may  be 
zero  or  blank) 


Remarks : 

1.  The  grid  points  define  either  a  triangular  or  a  quadri¬ 
lateral  surface  to  which  a  pressure  is  applied.  If  G4  is 
zero  or  blank,  the  surface  is  triangular. 

2.  In  the  case  of  a  triangular  surface,  the  assumed  direction 
of  the  pressure  is  computed  according  to  the  right-hand  rule 
using  the  sequence  of  grid  points  Gl,  G2,  and  G3  as  illus¬ 
trated  below. 


G3 


The  total  load  on  the  surface,  AP,  is  divided  into  three 
equal  parts  and  applied  to  the  grid  points  as  concentrated 
loads.  A  minus  sign  in  field  3  reverses  the  direction  of 
the  load. 

3.  In  the  case  of  a  quadrilateral  surface,  the  grid  points  Gl, 
G2 ,  G3,  and  G4  should  form  a  consecutive  sequence  around  the 
perimeter.  The  right-hand  rule  is  applied  to  find  the 
assumed  direction  of  the  pressure.  Four  concentrated  loads 
are  applied  to  the  grid  points  in  approximately  the  same 
manner  as  for  a  triangular  surface.  The  following  specific 
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procedures  are  adopted  to  acconnodate  irregular  and/or 
warped  surfaces: 

a.  The  surface  is  divided  into  two  sets  of  overlapping 
triangular  surfaces.  Each  triangular  surface  is  bounded 
by  two  of  the  sides  and  one  of  the  diagonals  of  the 
quadrilateral . 

b.  One -half  of  the  pressure  is  applied  to  each  triangle 
which  is  then  treated  in  the  manner  described  in  Remark 
2. 
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Input  Data  Entry  PMASS  Scalar  Mass  Property 


Description:  Used  to  define  the  mass  value  of  a  scalar  mass  element  which 

is  defined  by  means  of  the  CMASS1  entries. 

Format  and  Examples: 


ELeld 

PID 

M 

TMIN 
Remarks : 


Content? 

Property  identification  number  (Integer  >  0). 

Value  of  scalar  mass  (Real). 

The  minimum  mass  value  in  design.  Default  -  0.0001 

1.  This  entry  defines  a  mass  value. 

2.  Up  to  two  mass  values  may  be  defined  by  this  entry. 

3.  TMIN  is  ignored  unless  the  mass  element  is  linked  to  design 
variables  through  ELIST  entries. 


Input  Data  Entry  P0DMEM1  Quadrilateral  Membrane  Property 


Description:  Used  to  define  the  properties  of  a  quadrilateral  membrane 

referenced  by  the  CQDMEM1  entry.  No  bending  properties  are 
included. 

Format  and  Examples: 


Field 

PID 

MID 

T 

NSM 

TMIN 

Remarks: 


Contents 

Property  identification  number  (Integer  >  0). 

Material  identification  number  (Integer  >  0) . 

Thickness  of  membrane  (Real  >  0.0) 

Nonstructural  mass  per  unit  area  (Real) . 

Minimum  thickness  for  design  (Real  >  0.0  or  blank).  Default 

-  0.0001. 

1.  All  PQDMEM1  entries  must  have  unique  property  identification  r"  ( 

numbers . 

2.  TMIN  is  ignored  unless  the  element  is  linked  to  the  global 
design  variable  by  ELIST  entries. 

I 


j 


I 
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Input  Data  Entry  PROD  Rod  Property 


Description:  Defines  the  properties  of  a  rod  which  is  referenced  by  the 

CROD  entry. 


Format  an4-EMffiRlg.s : 


1  2  3  4  5  6  78  9  10 


m 

■Ti»B 

-  mm  __ 

flRH 

MS 

VM>H 

bum 

III l*B 

H BI1 

EH 

■BM 

B 

* 

Fiejd 

PID 

MID 

A 

J 

C 

NSM 

THIN 


Remarks : 


Contents 

Property  identification  number  (Integer  >  0). 

Material  identification  number  (Integer  >  0). 

Area  of  rod  (Real) . 

Torsional  constant  (Real). 

Coefficient  to  determine  torsional  stress  (Real) 
Nonstructural  mass  per  unit  length  (Real). 

Minimum  rod  area  for  design  (Real  >  0.0  or  blank).  Default 
-  0.0001 

1.  PROD  entries  must  all  have  unique  property  identification 
numbers . 

2.  For  structural  problems,  PROD  entries  may  only  reference 
MAT1  material  entries. 

3.  The  formula  used  to  compute  torsional  stress  is: 

cM„ 

r  -  — i 

J 


where  Mg  is  the  torsional  moment. 

4.  TMIN  is  ignored  unless  the  rod  element  is  linked  to  the 
design  variables  by  ELIST  entries. 


I 


« 
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Input  Data  Entry  PSHEAR  Shear  Panel  Property 


Description:  Defines  the  elastic  properties  of  a  shear  panel.  Referenced 

by  the  CSHEAR  entry. 

Fornat  and  Examples: 


1 

_  2 

3 

4 

5 

_ 6 _ 

7 

8 

9 

10 

PSHEAR 

PID 

MID 

T  1 

1  NSM _ 1 

1 

PSHEAR 

_ 13 _ 

_2 _ 

MEM 

wrwm 

1 

El£l4 

PID 

MID 

T 

NSM 

TMIN 

Remarks : 


Contents 

Property  identification  number  (Integer  >  0). 

Material  Identification  number  (Integer  >  0). 

Thickness  of  shear  panel  (Real  -  0.0) 

Nonstructural  mass  per  unit  area  (Real) . 

Minimum  panel  thickness  for  design  (Real  >  0.0  or  blank). 
Default  -  0.0001 

1.  All  PSHEAR  entries  must  have  unique  identification  numbers. 

2.  PSHEAR  entries  may  reference  only  MAT1  material  entries. 

3.  TMIN  is  ignored  unless  the  element  is  linked  to  global 
design  variables  by  ELIST  entries. 
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Input  Data  Entry  PSHELL  Shell  Element  Property 

Description:  Defines  the  membrane,  bending,  transverse  shear,  and  coupling 

properties  of  the  shell  elements.  (QUAD4) 

Format  and  Examples: 


1  2  3  4  5  6  7  8  9  10 


PSHELL 

ET9 

1  MIDI  1 

1 _ T _ 

1  MID2  1 

12I/T3 1 

1  MID3  1 

TS/T 

NSM 

CONT 

PSHELL _ 

1H 

KVT1 

mwm 

sn 

0.8 

6.32 

ABC 

CONT 

Z1 

Z2 

MID4 

BEET! 

vmm 

_ ZO _ 

■fLMvB 

+BC 

+  .95 

_-...u£5_ 

Bl 

0 

EX31 

Field  Contents 

PID  Property  identification  number  (Integer  >  0). 

MIDI  Material  identification  number  for  membrane  (Integer  >  0  or 

blank) . 

T  Default  value  for  membrane  thickness  (Real). 

MID2  Material  identification  number  for  bending  (Integer  >  0  or 

blank) 

12I/T^  Bending  stiffness  parameter  (Real  or  blank,  default  -  1.0). 

MID3  Material  identification  number  for  transverse  shear  (Integer 

>  0  or  blank,  must  be  blank  unless  MID2  >  0). 

TS/T  Transverse  shear  thickness  divided  by  membrane  thickness 

(Real  or  blank,  default  -  .833333). 

NSM  Nonstructural  mass  per  unit  area  (Real). 

Z1,Z2  Fiber  distances  for  stress  computation.  The  positive 

direction  is  determined  by  the  righthand  rule  and  the  order 
in  which  the  grid  points  are  listed  on  the  connection  entry. 
(Real  or  blank,  defaults  are  -1/2  T  for  Z1  and  1/2  T  for 
Z2 .  ) 

MID4  Material  identification  number  for  membrane -bending  coupling 

(Integer  >  0  or  blank,  must  be  blank  unless  MIDI  >  0  and 
MID2  >  0,  may  not  equal  MIDI  or  MID2). 

MCSID  Identification  number  of  material  coordinate  system  (Real  or 

blank,  or  Integer  >  0)  (See  Remark  9) 

SCSID  Identification  number  of  stress  coordinate  system  (Real  or 

blank,  or  Integer  >  0)  (See  Remark  9) 


i 


1 


-1 
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zo 

TMIN 

Remarks : 


Offset  of  the  mid  reference  plane  from  the  plane  of  grid 
points.  (Real  or  blank,  default  -  0.0)  (See  Remark  10) 

Minimum  thickness  for  design  (Real  >  0.0  or  blank).  Default 

-  0.0001 


1.  All  PSHELL  property  entries  must  have  unique  identification 
numbers . 

2.  The  structural  mass  is  computed  from  the  density  using  the 
membrane  material  properties . 

3.  The  results  of  leaving  an  MID  field  blank  are: 

MIDI  No  membrane  or  coupling  stiffness. 

MID2  No  bending,  coupling,  or  transverse  shear  stiffness. 
MID3  No  transverse  shear  flexibility. 

MID4  No  bending-membrane  coupling. 

4.  The  continuation  entry  is  not  required. 

5.  The  MID4  field  should  be  left  blank  if  the  material  proper¬ 
ties  are  symmetric  with  respect  to  the  middle  surface  of  the 
shell . 

6.  This  entry  is  used  only  with  the  CQUAD4  elements. 

7.  PSHELL  entries  may  reference  MAT1 ,  MAT2,  or  MAT 8  material 
property  entries. 

8.  If  the  transverse  shear  material,  MID3,  references  MAT2 
data,  then  G33  must  be  zero.  If  MID3  references  MAT8  data, 
then  Gl,  Z  and  G2,  Z  must  not  be  zero. 

9.  If  MCSID/SCSID  is  left  blank  (0.0)  or  is  real,  it  is  consid¬ 
ered  to  be  the  angle  of  rotation  of  the  X  axis  of  the 
material/stress  coordinate  system  with  respect  to  the  X  axis 
of  the  element  coordinate  system  in  the  XY  plane  of  the 
latter.  If  integer,  the  orientation  of  the  material/stress 
x-axis  is  along  the  projection  of  the  x-axis  of  the  speci¬ 
fied  coordinate  system  onto  the  x-y  plane  of  the  element 
system.  The  value  of  MCSID  is  the  default  value  for  the  TM 
field  on  CQUAD4  Bulk  Data  entries. 

10.  The  value  of  ZO  is  the  default  value  for  the  corresponding 
field  on  CQUAD4  Bulk  Data  entries.  The  default  is  half  the 
thickness . 

11.  TMIN  is  ignored  unless  element  is  linked  to  global  design 
variables  by  ELIST  entries. 
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Input  Data  Entry  PTRMEM 

Description:  Defines  property  data  for  TRMEM  element. 
Format  and  Examples: 


_ 1 _ 

2 

3 

4 

5 

6 

7 

8 

9 

Blf 

T 

NSM 

TMIN 

m 

0.15 

field 

PID 

MID 

T 

NSM 

TMIN 

Remarks : 


Cpptepts 

Property  entry  identification  number  (Integer  >  0). 

Material  property  identification  (Integer  >  0). 

Thickness  of  membrane  element  (Real  >  0.0). 

Nonstructural  mass  associated  with  the  element. 

Minimum  thickness  for  design  (Real  >  0.0  or  blank).  Default 
-  0.0001 

1.  The  PTRMEM  entry  can  reference  either  MAT1 ,  MAT2  or  MAT8 
entries . 

2.  TMIN  is  ignored  unless  the  element  is  linked  to  global 
design  variables  by  ELIST  entries. 
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Input  Data  Entry  RL0AD1 

Description:  Defines  a  frequency  dependent  dynamic  load  of  the  form. 

P(f)  -  (A[C(f)  +  iD(f  ) )  ei<6  “  2,rfrh 

Format  and  Examples: 


Field 


Contents 


SID 
I  LAG 

TC 

TD 


Set  identification  number  (Integer  >  0) 

Identification  number  of  a  DLAGS  set  which  defines  A,  0  and 
r  (Integer  >  0) 

Set  identification  number  of  TABLEDi  entry  which  gives  %f) 
(Integer  >0;  TC  +  TD  >  0) 

Set  identification  number  of  TABLEDi  entry  which  gives  D(f) 
(Integer  >0;  TC  +  TD  >  0) 


Remarks : 


1.  RLOADl  loads  may  be  combined  with  RL0AD2  loads  only  by 
specification  on  a  DLOAD  entry. 


2. 


SID  must  be  unique  for  all  RLOADl,  RLOAD2 ,  TL0AD1  and  TL0AD2 
entries . 


Input  Data  Entry  RL0AD2 

v.  Description:  Defines  a  frequency  dependent  dynamic  load  of  the  form. 

P(f)  -  (AB(f)ei<^<f>  +  9  *  2*frh 

Format  and  Examples: 


Contents 

Set  identification  number  (Integer  >  0) 

Identification  of  a  DLAGS  entry  which  defines  A,  0  and  r 
(Integer  >  0) 

Set  Identification  number  of  TABLEDi  entry  which  gives  B(f) 
(Integer  >  0) 

Set  identification  number  of  TABLEDi  entry  which  gives  ^(f) 
in  degrees  (Integer  >  0) 

1.  RL0AD2  loads  may  be  combined  with  RL0AD1  loads  only  by 
specification  on  a  DLOAD  entry. 

2.  SID  must  be  unique  for  all  RL0AD1 ,  RL0AD2,  TL0AD1  and  TL0AD2 
entries . 


Field 

c 

SID 
I  LAG 

TB 

TP 

Remarks : 


Input  Data  Entry  SAVE 

Description:  Defines  a  list  of  data  base  entities  that  are  not  to  be  purged. 
Format  and  Examples: 

1  2  3  .  4  5  6  7  8  9  10 


OONT 

Ism _ 

■ 

■ 

■ 

CONT 

NAME9 

-etc . - 

-  -  •  1 

L—\ 

Field  Contents 

NAME!  The  name  of  a  data  base  entity  whose  contents  are  not  to  be 

purged . 

Remarks : 

1.  Any  number  of  continuations  are  allowed. 

2.  These  data  are  used  by  the  UTPURG  utility  to  determine  if  a 
requested  purge  of  an  entity  will  take  place. 


Input  Data  Entry  SEOGP  Grid  and  Scalar  Point  Resequencing 


Description:  Used  to  manually  order  the  grid  points  and  scalar  points  of  the 

problem.  The  purpose  of  this  entry  is  to  allow  the  user  to 
reidentify  the  formation  sequence  of  the  grid  and  scalar  points 
of  the  structural  model  in  such  a  way  as  to  optimize  bandwidth. 


Format  and  Examples: 

_ l _ 2  -3  4  5 _ 6  .  7  _  8 _ S _ 10 


1  SEOGP 

Lid 

t.'Koiil 

ID 

SEOID 

ID 

SEQID 

RlJ'l 

nil 

596 

0.2 

_ 2 _ 

rvnrm 

3 

CONT. 

ID 

SEOID 

-etc . - 

1 

9 


Field  Contents 

ID  Grid  point  identification  number  (Integer  >  0  ) 

SEQID  Sequenced  identification  number  (a  special  number  described 

below. 

Remarks : 

1.  ID  is  any  grid  or  scalar  point  identification  number  which 

is  to  be  reidentified  for  sequencing  purposes.  The  sequence 

number  is  a  special  number  which  may  have  any  of  the  follow¬ 
ing  forms  where  X  is  a  decimal  integer  digit  -  XXXX.X.X.X, 
XXXX.X.X,  XXXX.X  or  XXXX  where  any  of  the  leading  X's  may  be 
omitted.  This  number  must  contain  no  imbedded  blanks.  The 
leading  character  must  not  be  a  decimal  point. 

2.  If  the  user  wishes  to  insert  a  point  between  two  already 
existing  grid  or  scalar  points,  such  as  15  and  16,  for 
example,  he  would  define  it  as,  say  5392,  and  then  use  this 
entry  to  insert  extra  point  number  5392  between  them  by 
equivalencing  it  to,  say,  15.6.  All  output  referencing  this 
point  will  refer  to  5392. 

3.  The  SEQID  numbers  must  be  unique  and  may  not  be  the  same  as 
a  point  ID  which  is  not  being  changed.  No  extra  point  ID 
may  be  referenced  more  than  once. 

4.  If  a  point  ID  is  referenced  more  than  once,  the  last  refer¬ 
ence  will  determine  its  sequence. 
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Input  Data  Entry  SET1  Set  definition  for  aerodynamic  analyses. 
Description:  Defines  a  set  of  integers  by  a  list. 

Egaat.-aod  Exmrples: 


1  2  ?  ,  *  5  .  .6 _ 7  .  9 _ 2 _ HI 


SET1 

SID 

G1 

G2 

G3 

G4 

G5 

G6 

G7 

CQNT 

SET1 

3 

—SI— 

62 

—2.3— 

124 

16 

_  17— 

-15—. 

ABC 

CQNT 

G8 

-etc. - 

1 

+BC 

19 

Alternate  Form: 


123456789  10 


SET1 

SID 

Cl 

THRU 

G2 

1 

sm _ 

3 

5 

-THRU 

— IQ . 

field 

SID 

Gl,G2,etc. 

Remarks : 

2.  When  using  the  "THRU"  option,  all  intermediate  points  must 
exist . 

3.  When  used  by  SPLINE1,  the  entry  refers  to  a  list  of  struc¬ 
tural  grid  points. 

4.  When  used  by  FLUTTER,  the  entry  refers  to  mode  numbers  to  be 
omitted  in  the  flutter  analysis. 


Contents 

Set  of  identification  numbers  (Integer  >  0) 

List  of  integers  (Integer  >  0) 

1.  These  entries  are  referenced  by  the  SPLINE1  and  FLUTTER  data 
entries. 


Input  Data  Entry  SET2  Grid  Point  List 


Defines  a  set  of  structural  grid  points  in  terras  of  aerodynamic 
macroelements . 


SP1.SP2 


CH1.CH2 


ZMAX, ZMIN 


Set  identification  number  (Integer  >  0). 

Lower  and  higher  fractional  span  division  points  defining 
prism  containing  the  set  (Real  >  -.01  <  1.0). 

Lower  and  higher  fractional  chord  division  points  defining 
prism  containing  the  set  (Real  >  -.01  <  1.01). 

Z-coordinates  of  top  and  bottom  (using  right-hand  rule  with 
the  order  the  corners  as  listed  on  a  CAEROi  entry)  of  the 
prism  containing  the  set  (Real).  Usually  ZMAX  >  0.0,  ZMIN 
<  0.0. 


Remarks : 


These  entries  are  referenced  by  the  SPLINE1  data  entries. 

Every  grid  point,  within  the  defined  prism  and  within  the 
height  range,  will  be  in  the  set.  For  example, 


The  shaded  area  in  the  figure  defines  the  cross-section  of 
the  prism  for  the  sample  data  given  above.  Points  exactly 
on  the  boundary  may  be  missed;  hence,  to  get  all  the  grid 
points  within  the  area  of  the  macro  element,  use  SP1  -  -.01, 
SP2  -  1.01,  etc. 

A  zero  value  for  ZMAX  or  ZMIN  implies  infinity  is  to  be 


Input  Data  Entry  SPC  Single -Point  Constraint 

IteSCEiPtlPn:  Defines  sets  of  single-point  constraints  and  enforced 

displacements . 

Format  and  Examples: 


_ 1 _ 

_ 2 _ 

3 

4 

_ 5 _ 

6 

7 

8 

9 

■Tim 

G 

Lc _ 1 

n 

G 

C 

1 _ D _ 1 

1 

_ 2 _ 

-  12 _ 

wzrm 

n i 

_ 

BO 

Els  14 
SID 

G 

C 


D 


Remarks : 


Contents 

Identification  number  of  single-point  constraint  set  (Inte¬ 
ger  >  0) 

Grid  or  scalar  point  identification  number  (Integer  >  0) 

Component  number  of  global  coordinate  (6  >  Integer  >0;  up 
to  six  unique  digits  may  be  placed  in  the  field  with  no 
imbedded  blanks. 

Value  of  enforced  displacement  for  all  coordinates  defined 
by  G  and  C  (Real) 


1.  Coordinates  specified  on  this  entry  form  members  of  a 
mutually  exclusive  set.  They  may  not  be  specified  on  other 
entries  that  define  mutually  exclusive  sets. 

2.  Single-point  forces  of  constraint  may  be  recovered  during 
data  recovery. 

3.  Single-point  constraint  sets  must  be  selected  in  Solution 
Control  (SPC  -  SID)  to  be  used. 

4.  From  one  to  twelve  single -point  constraints  may  be  defined 
on  a  single  entry. 

5.  SPC  degrees  of  freedom  may  be  redundantly  specified  as 
permanent  constraints  on  the  GRID  entry. 


6. 


Continuation  entries  are  not  allowed. 


Input  Data  xEntry  SPCADD 


Single -Point  Constraint  Set  Combination 


Description:  Defines  a  single-point  constraint  set  as  a  union  of  single 

point  constraint  sets  defined  via  SPC  or  SPC1  entries. 

Format  and  Examples : 


Field 


Contents 


SID 

Si 


Remarks : 


Identification  number  for  new  single -point  constraint  set 
(Integer  >  0) 

Identification  numbers  of  single-point  constraint  sets 
defined  via  SPC  or  by  SPCl  entries  (Integer  >  0;  SID  *  Si) 


1.  Single-point  constraint  sets  must  be  selected  in  Solution 
Control  (SPC  -  SID)  to  be  used. 

2.  No  Si  may  be  the  identification  number  of  a  single-point 
constraint  set  defined  by  another  SPCADD  entry. 

3.  The  Si  values  must  be  unique. 

4.  SPCADD  entries  take  precedence  over  SPC  or  SPCl  entries.  If 
both  have  the  same  set  ID,  only  the  SPCADD  entry  will  be 
used. 
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Input  Data  Entry  SPCl  Single-Point  Constraint,  Alternate  Form  1 

Description:  Defines  sets  of  single-point  constraints 
Format  and  Examples: 


1  2  3  4  5  6  7  8  9  10 


SPCl 

SID 

C 

G1 

G2 

G3 

G4 

G5 

G6 

CONT 

SfCl _ 

3 

_ 2 _ 

_1 _ 

_ i _ 

10 

9 

6 

5 

ABC 

CQNT 

G7 

G8 

G9 

-etc. - 

1 

+BC 

2 

8 

Alternate  For* 


Field  Contents 

SID  Identification  number  of  single-point  constraint  set  (Inte¬ 

ger  >  0) 

C  Component  number  of  global  coordinate:  any  unique  combina¬ 

tion  of  the  digits  1-6  (with  no  imbedded  blanks)  when  point 
identification  numbers  are  grid  points;  must  be  blank  or 
zero  if  point  identification  numbers  are  scalar  points. 

Gi.GIDi  Grid  or  scalar  point  identification  numbers  (Integer  >  0) 


Remarks : 

1.  Note  that  enforced  displacements  are  not  available  via  this 
entry.  As  many  continuation  entries  as  desired  may  appear. 

2.  Coordinates  specified  on  this  entry  form  members  of  a 
mutually  exclusive  set.  They  may  not  be  specified  on  other 
entries  that  define  mutually  exclusive  sets. 

3.  Single-point  constraint  sets  must  be  selected  in  Solution 
Control  (SPC  -  SID)  to  be  used. 

4.  SPC  degrees  of  freedom  may  be  redundantly  specified  as 
permanent  constraints  on  the  GRID  entry. 

5.  If  the  alternate  form  is  used,  points  in  the  sequence  GID1 
through  GID2  are  required  to  exist. 
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Input  Data  Entry  SPLINE1  Surface  Spline 

Description:  Defines  a  surface  spline  for  interpolating  out-of-plane  motion 

for  aeroelastic  problems. 

Format  and  Examples: 

_ 1 _ 2 _ 3  4  5  6  7 _ 8 _ 9 _ IQ_ 


EID 

CP 

ME® 

ME® 

M17B 

WK&tL 

1 

—2 _ 

im 

_ 14 _ 

0.0 

Contents 

Element  identification  number  (Integer  >  0) 

Coordinate  system  defining  the  spline  plane 

Aero  element  ID  which  defines  plane  of  spline  (Integer  >  0) 

First  and  last  box  whose  motions  are  interpolated  using  this 
spline  (Integer  >  0,  B0X2  >  BOXl) 

Refers  to  a  SETi  entry  which  lists  the  structural  grid 
points  to  which  the  spline  is  attached  (Integer  >  0) 

Linear  attachment  flexibility  (Real  >0.0) 


The  interpolated  points  (k-set)  will  be  defined  by  aero- 
cells.  The  sketch  shows  the  cells  for  which  u^  is  interpo¬ 
lated  if  BOXl  -  111  and  B0X2  -  118. 


2.  The  attachment  flexibility  (units  of  area)  is  used  for 
smoothing  the  interpolation.  If  DZ  -  0.0,  the  spline  will 
pass  through  all  deflected  grid  points.  If  DZ  »  (area  of 
spline),  a  least  squares  plane  fit  will  occur.  Intermediate 
values  will  provide  smoothing. 

3.  If  no  CP  is  specified,  the  spline  plane  is  assumed  to  be 
the  CAERO  macro  element  plane. 

A.  The  SPLINE  EID  is  used  only  for  error  messages  and  need  not 
be  related  to  the  macroelement  identification  number. 
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Field 

EID 

CP 

CAERO 
BOXl , BOX2 

SETG 

DZ 

Remarks : 

1. 


J 


pTTrnHi 

WFTM 

UniiiatU 

wrm 

1  1 

1  1 

■  ■ 

1  ■ 

ISPPIKT 

5_. 

BTTnT® 

Field  Contents 

ID,  ID1,  ID2  Scalar  point  identification  number  (Integer  >  0;  ID1  <  ID2) 


Remarks : 


1. 


If  the  alternate  form  is  used,  all  scalar  points  IDl  through 
ID2  are  defined. 


Input  Data  Entry  SUPORT  Fictitious  Support 

Description:  Defines  coordinates  at  which  the  user  desires  determinate 

reactions  to  be  applied  to  a  free  body  during  analysis. 

Format  and  Examples: 


1 

_ 2 _ 

_ 3 _ 

4 

5 

6 

7 

8 

__9 

SUPORT 

RT3TM 

V7W 

1 _ c 

ID 

C 

1  ID  1 

1  c  1 

1  1 

I _ I 

SUPORT 

.... 

wjvm 

■  ■ 

■  ■ 

■  ■ 

■  ■ 

Field  Contents 

SETID  Solution  control  SUPPORT  set  identification  (Integer  >  0). 

ID  Grid  or  scalar  point  identification  number  (Integer  >  0). 

C  Component  number  (zero  or  blank  for  scalar  points;  any 

unique  combination  of  the  digits  1-6  for  grid  points). 


Remarks : 

1.  Coordinates  specified  on  this  entry  form  members  of  a 
mutually  exclusive  set.  They  may  not  be  specified  on  other 
entries  that  define  mutually  exclusive  sets. 

2.  From  one  to  eighteen  support  coordinates  may  be  defined  on  a 
single  entry. 

3.  Continuation  entries  are  not  allowed. 
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Input  Data  Entry  TABDMP1  Modal  Damping  Table 

Description:  Defines  modal  damping  as  a  tabular  function  of  frequency. 

Format  and  Examples: 


1  2 _ 3  4  5 _ 6 _ 7 _ 8 _ 9 _ 10 


TABDMP1 

ID 

TYPE 

Fl 

Gl 

f2 

g2 

F3 

G3 

CONT 

TABDMP1 

3 

£  ... 

0.0 

0.005 

1.0  - 

0.008 

2.0 

wwm 

ABC 

CONT 

F4 

G4 

F5 

G5 

F6 

g6 

etc 

+BC 

ra i 

.01057 

2-,6._ 

-.01162 

■ 

1  ■ 

■  ■ 

■ 

■  ■ 

Held 


Contents 


ID 

TYPE 


Fi 

Gi 

Remarks : 


Table  identification  number  (Integer  >  0) . 

Data  word  which  indicates  the  type  of  damping  units,  "G", 
"CRIT",  "Q",  or  blank.  Default  is  "G" . 

Frequency  value  in  cycles  per  unit  time  (Real  >  0.0). 

Damping  value  (Real). 


1.  The  must  be  in  either  ascending  or  descending  order  but 
not  both. 

2.  Jumps  between  two  points  (F^  -  Fj+^)  are  allowed,  but  not  at 
the  end  points. 

3.  At  least  two  entries  must  be  present. 

4.  Any  f^,  g^  entry  may  be  ignored  by  placing  the  string  "SKIP" 
in  either  of  two  fields  used  for  that  entry. 

5.  The  TABDMP1  mnemonic  infers  the  use  of  the  algorithm 

g  -  gT<F> 

where  F  is  input  to  the  table  and  g  is  returned.  The  table 
look-up,  gx(F),  is  performed  using  linear  interpolation 

within  the  table  and  linear  extrapolation  outside  the  table 
using  the  last  two  end  points  at  the  appropriate  table  end. 
At  jump  points  the  average  gj(F)  is  used.  There  are  no 
error  returns  from  this  table  look-up  procedure. 

6.  If  TYPE  is  "G"  or  blank,  the  damping  values  are  in  structur¬ 

al  damping  units,  that  is,  the  value  of  g  in  (l+ig)K.  If 
TYPE  is  "CRIT" ,  the  damping  values  are  in  the  units  of 

fraction  of  critical  damping,  C/Cq.  If  TYPE  is  "Q",  the 
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I 


damping  values  are  In  the  units  of  the  amplification  or 
quality  factor,  Q.  These  constants  are  related  by  the 
following  equations: 

C/C0  -  g/2, 


Q 


1/(2C/C0), 


Input  Data  Entry  TABLED 1 

Description:  Defines  a  tabular  function  for  use  in  generating  frequency 

dependent  and  time -dependent  dynamic  loads. 

Format  and  Examples: 


1 

_ 2 _ 

3 

4 

5 

6 

7 

8 

9 

10 

TABLED1 

1  CONT  1 

TABDMP1 

32 

■ 

■ 

— M 

■ 

— 

■  ■ 

■ 

wrm 

CONT 

X1 

yi 

x2 

Y2 

x3 

Y3 

-etc- 

CONT 

+BC 

-3.0 

6 , 9 _ 

-2JL- 

5.8 

3.0 

.-^6  _ 

Field  Contents 

ID  Table  identification  number  (Integer  >  0) 

X£ ,  yi  Tabular  entries  (Real) 

Remarks : 

1.  The  xj  must  be  in  either  ascending  or  descending  order  but 
not  both. 

2.  Jumps  between  two  points  (x^  -  xj+j)  are  allowed,  but  not  at 
the  end  points. 

3.  At  least  two  entries  must  be  present. 

4.  Any  x-y  entry  may  be  ignored  by  placing  the  string  "SKIP"  In 
either  of  the  two  fields  used  for  that  entry. 

5.  The  generated  function  is: 

Y  -  yT(X) 

where  X  is  input  to  the  table  and  Y  is  returned.  The  table 
look-up  yj(x)  is  performed  using  linear  interpolation  within 
the  table  and  linear  extrapolation  outside  the  table  using 
the  last  two  end  points  at  the  appropriate  table  end.  At 
jump  points  the  average  yj(x)  is  used.  There  are  no  error 
returns  from  this  table  look-up  procedure. 
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Input  Data  Entry  TEMP  Grid  Point  Temperature  Field 

Description:  Defines  temperature  at  grid  points  for  determination  of  (1) 

Thermal  Loading;  and  (2)  data  recovery. 

Format  and  Examples: 


123456789  10 


urns 

KHI 

G 

_ I _ 

G 

_ T _ 

G 

T 

1 

mi 

3 

94 

mm 

49 

FHJFI 

1 

Field 

SID 

G 

T 

Remarks : 


Contents 

Temperature  set  identification  number  (Integer  >  0) . 
Grid  point  identification  number  (Integer  >  0). 
Temperature  (Real). 


1.  From  one  to  three  grid  point  temperatures  may  be  defined  on 
a  single  entry. 

2.  Average  element  temperatures  are  obtained  as  a  simple 
average  of  the  connecting  grid  point  temperatures  when  no 
element  temperature  data  are  defined. 

3.  For  each  thermal  load,  temperatures  must  be  specified  for 
all  grid  points  using  either  TEMP  or  TEMPD  entries. 
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Input  Data  Entry  TEMPD  Grid  Point  Temperature  Field  Default 


Description:  Defines  a  temperature  value  for  all  grid  points  of  the 

structural  model  which  have  not  been  given  a  temperature  on  a 
TEMP  entry. 

Format  and  Examples: 


1 

2 

3 

4 

5  _ 

6 

7 

...  8  _ 

9 

10 

TEMPO 

SID 

T 

SID 

T 

SID 

T 

SID 

T 

TEMPD 

_1 _ 

1UJ.. 

Field 

SID 

T 

Remarks : 


Cpnt.gpts 

Temperature  set  identification  number  (Integer  >  0  or 

blank) . 

Default  temperature  value  (Real). 


1.  From  one  to  four  default  temperatures  may  be  defined  on  a 
single  entry. 

2.  Average  element  temperatures  are  obtained  as  a  simple 
average  of  the  connecting  grid  point  temperatures  when  no 
element  temperature  data  are  defined. 

3.  For  each  thermal  load,  temperatures  must  be  specified  for 
all  grid  points  using  either  TEMP  or  TEMPD  entries. 
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Input  Data  Entry  I£  Dynamic  Transfer  Function 


1.  Used  to  define  a  transfer  function  of  the  form 

(B  +  Blp  +  B2p2)ud  +  2  (AO(i)  +  Al(i)p  +  A2(i)p2)ui  -  0.0 

i 

2.  May  also  be  used  as  a  means  of  direct  matrix  input.  See 
Remark  3. 


Format  and  Examples: 


1 

2 

3 

4 

3 

6 

7 

8 

9 

10 

TF 

SID 

GD 

...  CD. 

BO 

31 

B2 

CONT 

IE _ 

1 

2 

3 

_4,Q— . 

5.0 

6,0 

+ABC 

CONT 

G(  1) 

C(l) 

A0(1) 

Al(l) 

|A2(1) 

CONT  1 

*ABC 

3 

4 

5,0 

6.0 

7.0 

Field  Contents 

SID  Set  identification  (Integer  >  0) . 


GD.G'i) 


Grid,  scalar  or  extra  point  identification  numbers  (Integer 
>  0). 


CD,C(i) 


Component  numbers  (null  or  zero  for  scalar  or  extra  points, 
any  one  of  the  digits  1-6  for  a  grid  point). 


B0.B1.B2 

A0(i),Al(i),  Transfer  function  coefficients  (Real). 

A2(i) 


Remarks : 


1.  The  matrix  elements  defined  by  this  entry  are  added  to  the 
dynamic  matrices  for  the  problem. 


2.  Transfer  function  sets  must  be  selected  in  Solution  Control 

(TFL  -  SID)  to  be  used.  j 

3.  The  constraint  relation  given  in  the  equation  will  hold  only 
if  no  structural  elements  or  other  matrix  elements  are 
connected  to  the  dependent  coordinate,  ud.  In  fact,  the 
terms  on  the  left  side  of  the  equation  are  simply  added  to 

the  terms  from  all  other  sources  in  the  row  for  ud.  | 

4.  Any  number  of  continuations  are  allowed. 


I 
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Input  Data  Entry  TIMELIST 


Description:  Defines  a  list  of  times  at  which  outputs  are  desired. 

Format  and  Examples: 


1  .2  3  4  5  6  7  8  9  10 


1#t,i 

■m 

■77TV 

■TTi  W 

■7TT1 

m 

m 

nm 

■fArtf 

L  4  1  -  '  kf  yM 

mum 

Ejnii 

mu 

BU 

■■■ 

I^aHI 

Hf  vlyf-’B 

■  Ilil'V 

HHB 

■  ■ 

■  ■ 

BBHI 

n&u 

Contents 

SID 

Set  identification  number  referenced  by 
Integer  >  0  ) 

Solution 

Control 

TIME 

Time,  (in  consistent  time  unit)  at  which 
sired.  (Real) 

outputs 

are  de- 

Begatte : 

1. 

In  order  to  be  used,  the  SID  must  be  referenced  by 
Control. 

Solution 

2. 

The  nearest  time  to  TIME,  either  above  or 
used  in  the  Transient  Response  analysis 

below,  which  was 
will  be  used  to 

satisfy  the  output  requests. 

3.  Any  number  of  continuations  is  allowed. 


. 

' 


V 


« 


i 
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Input  Data  Entry  TL0AD1 

Description:  Defines  a  time  dependent  motion  of  the  form: 


P { T }  -  (A  F  (t  -  r)} 

for  use  in  a  transient  response  problem. 

Egna&L-an&  Examples : 


1_ 

_2  _ 

3 

U 

5 

6 

7 

_  8 

9 

10 

TLOAD1 

SID 

DLAGID 

TID 

TL0AD1 

10 

8 

El&lri 


Contents 


SID  Set  identification  number  (Integer  >  0) 

DLAGID  Identification  number  of  DLAGS  set  which  defines  A  and  r 

(Integer  >  0) 

TID  Identification  number  of  a  TABLED1  entry  which  gives  F(t-r) 

(Integer  >  0) 


Remarks : 


1. 


SID  must  be  unique  for  all  TL0AD1,  TL0AD2,  RL0AD1,  and 
RL0AD2  entries. 


Input  Data  Entry  TL0AD2 

Description:  Defines  a  time -dependent  dynamic  load  of  the  form: 

{{0} .  t  <  0  or  t  >  T2  -  T1 
_ 

{AtB  e  ct  cos  (2*Ft  f-  4>) ) ,  0  <  t  <  T2  -  T1 
for  use  in  a  transient  response  problem  where  t  -  t  -  T1  -  r . 


Format  and  Examples: 

1  2  3  4  5  6  7  8  9  10 


m+m 

MrRlM 

rzmm 

R5S55A 

— f 

n 

vm 

Bn 

wncm 

VT1FI 

Km 

field 

Contents 

SID 

Set  identification  number  (Integer  >  0) 

DLAGID 

Identification  number  of  the  DLAGS  entry  set  which  define 
the  time  invariant  load  A  and  the  time  delay  r  (Integer  >  0) 

T1 

Time  constant  (Real  >  0.0) 

T2 

Time  constant  (Real,  T2  >  Tl) 

FREQ 

Frequency  in  cycles  per  unit  time  (Real  >  0.0) 

PHASE 

Phase  angle  in  degrees  (Real) 

CTEXP 

Exponential  coefficient  (Real) 

GROWTH 

Remarks : 

Growth  coefficient  (Real) 

1. 

TL0AD2  loads  may  be  combined  with  TL0AD1  loads  only  by 
specification  on  a  DL0AD  entry. 

2. 

SID  must  be  unique  for  all  TL0AD1,  TL0AD2,  RL0AD1  and  RL0AD2 
entries . 
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Input  Data  Entry  TRIM  Trim  Variable  Constraint 
Description:  Specifies  conditions  for  aeroelastic  trim  analysis. 
Format  and  Example: 


1  2  3  4  5  6  7  8  9  10 


(ETC— 

BMJi 

E73TJ7T3 

bkhb 

1H7*H 

b  ■ 

r&m 

h?i^iii 

Bcm 

BIBB 

BIB 

mwm 

EKB 

HE JEH 

■  m 

Eifild 

Contents 

TID 

Trim  set  identification  number  (Integer  >  0) 

MACH 

Mach  number  (Real  >0.0) 

QDP 

Dynamic  pressure  (Real  >  0.0) 

SYMXZ 

Symmetry  key  for  aero  coordinate  xz  plane  (Integer)  (+1  for 
symmetry,  0  for  no  symmetry,  -1  for  antisymmetry). 

TRMTYP 

Type  of  trim  required  (0  -  No  trim,  1  -  trim  lift  forces 
only,  2  -  trim  lift  and  pitching  moment) (Integer) 

NZ 

Load  factor  or  acceleration  (Real) 

QRATE 

Aircraft  pitch  rate  (rad/sec) (Real) 

VO 

Aircraft  velocity  (Real) 

Remarks : 

1. 

The  TRIM  entry  is  selected  in  solution  control  by  "TRIM  - 
TID." 

2, 

Units  on  the  inputs  are: 

QDP  -  Force/unit  area. 

NZ  -  This  input  is  dimensioned  with  units  of 
length/sec^  unless  a  MASS  conversion  factor  has 
been  given,  in  which  case  NZ  is  non- dimension¬ 
al.  Acceleration  used  by  the  pr<*)grc9ra  is  equal 
to  NZ/MAS5,  where  MASS  is  inp*s?  on  th.*  CONVERT 
data  entry  or  is  defaulted  to  1.$ 

QRATE  -  Rad/ sec 


‘Irate  “ 


g(NZ-l.O) 

VO 


VO  -  Length/sec 


where  th-?  length,  area  and  force  units  must  be  consistent 
with  the  remaining  hulk  data  entries. 


3.  QRATE  and  VO  are  required  only  when  TRMTYP  -  2. 

4.  Symetric  analyses  are  for  longitudinal  motions  while  anti¬ 
symmetric  analyses  are  for  lateral  motions. 


Input  Data  Entry  TSTEP 


b 


I' 


Description:  Defines  time  step  intervals  at  which  a  solution  will  be  gener¬ 

ated  and  output  in  transient  analyses. 

Format  and  Examples: 


l 

...  2 

3 

4 

5 

6 

7 

8 

9 

BliB 

TSTEP 

SID 

Nm 

IPT(l)  1 

Nom 

CONT 

TSIEL  . ... 

2 

10 

■nm 

5 

+ABC 

wzrm 

i  ■ 

mmm i 

■  ■ 

n 

■wm 

ni 

■■■ 

■ 

■■■ 

■  ■ 

mm 

-etc .  - 


Field 

Contents 

SID 

Set  identification  number  (Integer  >  0) 

N(i) 

Number  of  time  steps  of  value  DT(i)  (Integer  >  2) 

DI(i) 

Time  increment  (Real  >  0.0) 

N0(i) 

Skip  factor  for  output  (every  N0(i)t^  step  will  be  saved  for 
output)  (Integer  >  0) 

Remarks: 

1. 

TSTEP  entries  must  be  selected  in  the  Solution  Control 
(TSTEP-SID) . 

2. 

Note  that  the  entry  permits  changes  in  the  size  of  the  time 
step  during  the  course  of  the  solution.  Thus,  in  the 
example  shown,  there  are  10  time  steps  of  value  .001  fol¬ 
lowed  by  9  time  steps  of  value  .01.  Also,  the  user  has 
requested  that  output  be  recorded  for  t  -  0.0,  .005,  .01, 
.02,  .03,  etc. 
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Input  Data  Entry  VSDAMP 


Description:  Specifies  values  of  g  and/or  W3  to  generate  either  viscous 
damping  that  has  the  same  damping  forces  as  structural  damping 
of  magnitude  g  at  the  frequency  W3  or  to  specify  the  structural 
damping  g  (see  Remarks  3  and  4) 

Format  and  Examples: 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

VSDAMP 

SID 

G 

w3 

SID 

G 

<*>3 

mvwm 

Field 

SID 

G 

u>3 

Remarks : 


Contents 

Set  identification  number  (Integer  >  0) 
Damping  value  (Real) 

Frequency  value  in  Hertz  (Real) 


1.  The  setid  is  selected  by  the  DAMPING-n  command  in  Solution 
Control. 


2.  Up  to  two  values  of  g  and  (*>3  can  be  defined  on  a  single 
entry. 

3.  If  W3  is  zero,  g  will  be  used  to  generate  a  complex  stiffness 
matrix  of  the  form  K  -  (1  +  ig)K. 


4.  If  W3  is  nonzero,  a  viscous  damping  matrix  of  the  form 


IB] 


[K] 


is  generated. 
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